Skip to content

List webhook subscriptions for the authenticated team

GET
/api/v1/webhooks
curl --request GET \
--url https://your-orimora-instance.example.com/api/v1/webhooks \
--header 'Authorization: Bearer <token>'

Returns all webhook subscriptions belonging to the API key’s team. Intended for integration tooling (n8n webhookMethods.checkExists) to verify a subscription still exists. For CRUD operations use the session-only /api/webhooks.* endpoints.

Webhook list (no pagination — typically < 20 per team)

Media type application/json
object
data
required
Array<object>
object
id
required
string format: uuid
teamId
required
string format: uuid
url
required
string format: uri
events
required

Event names this webhook subscribes to. Examples: document.created, collection.updated. See the Webhooks tag for the full list.

Array<string>
enabled
required
boolean
createdAt
required
string format: date-time
lastDeliveryAt
required
string | null format: date-time
Example generated
{
"data": [
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"teamId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"url": "https://example.com",
"events": [
"example"
],
"enabled": true,
"createdAt": "2026-04-15T12:00:00Z",
"lastDeliveryAt": "2026-04-15T12:00:00Z"
}
]
}

Missing / invalid API key

Media type application/json
object
error
required

Human-readable error message

string
Example generated
{
"error": "example"
}

API key lacks the read scope

Media type application/json
object
error
required

Human-readable error message

string
Example generated
{
"error": "example"
}