Sources

The source object

{
  "id": "01m3m4v8kq0c6f3qg2x7w9d1ne",
  "projectId": "01k5ztq3jb9y2a1m9v2xw8e0ha",
  "name": "Mobile money payments",
  "url": "https://hooks.digitospace.com/in/src_k7m2q9x4v1c8r3t6w0z5b2n8h4j6p1d3",
  "createdAt": "2026-10-01T08:30:00Z",
  "updatedAt": "2026-10-01T08:30:00Z"
}

Fields you send

namestringRequired

1 to 100 characters, on one line. Unique among the project’s sources, ignoring case.

Fields we add

idstring

The source’s ID. It never changes, even when you rename the source or reset its address.

projectIdstring

The project the source belongs to.

urlstring

The address senders send webhooks to, with any method and any path after it. It is the source’s secret. See Receive webhooks.

createdAtstring

When the source was created.

updatedAtstring

When the source was last changed.

List sources

Returns the project’s sources, newest first, a page at a time. See Paging.

Create a source

Send its name. Returns 201 with the new source. A name already used gets 409 with the code hooks_name_taken, and a project that holds 100 sources gets 403 with the code hooks_limit_reached.

Read a source

Rename a source

Send its new name. The address stays the same.

Reset the address

Gives the source a new url, and returns the source. Webhooks sent to the old address are no longer kept.

Delete a source

Deletes the source, its connections, and every event it received, with their deliveries. Returns 204. This cannot be undone.