Get started
Organization

Webhooks

Webhooks

Where an organization's webhook events are delivered, and how reliably: its endpoints, every event recorded, every delivery made, to an endpoint or as a notification email, and the reliability report that keeps Mountaya's service availability apart from each endpoint's success. Every operation here needs a session token beside the key.

The WebhookEndpoint object

A webhook endpoint: a URL of the organization's own that Mountaya delivers webhook events to, signed with the endpoint's secret. The secret is answered once, by postOrganizationWebhookEndpoint, and never by a read.

id

string (uuid)

required

Identifier of the endpoint, the webhook_endpoint_id a delivery names.

organization_id

string (uuid)

required

Identifier of the organization the endpoint belongs to.

url

string (uri)

required

The URL Mountaya delivers to: https, on a host that resolves to a public address, answered within 10 seconds. A redirect is never followed.

description

string | null

required

What the endpoint is for, as the organization wrote it, null when it has none.

enabled_events

array of string

required

The event types the endpoint is sent: each a member of WebhookEventType, a family followed by .* for every type of the family, such as organization.member.*, or * for every public type, those added to the contract later included.

status

string

required

One of: enabled, disabled

Whether Mountaya delivers to the endpoint.

disabled_reason

string | null

required

One of: requested, failing

Why the endpoint is disabled, null while it is enabled.

disabled_at

string (date-time) | null

required

When the endpoint was disabled, null while it is enabled.

failing_since

string (date-time) | null

required

When the endpoint's run of failed deliveries began, null while its last delivery succeeded. At 24 hours Mountaya records organization.webhook_endpoint.failing and emails the organization's owners and admins; at 72 hours it disables the endpoint. A delivery that succeeds after the run was reported records organization.webhook_endpoint.recovered. Read it before enabling a disabled endpoint again, which clears it, to redeliver from it.

etag

string

required

The version of the endpoint, the one the ETag of a read of it carries, opaque and compared whole. It moves on every change to the endpoint's configuration and status, and never with its health: a delivery failing or succeeding again moves failing_since and leaves it as it is. Send it as If-Match to make patchOrganizationWebhookEndpoint or deleteOrganizationWebhookEndpoint conditional.

created_by

RelationToUser | null

required

The member who created the endpoint, null when their account has been deleted.

See the RelationToUser object.

created_at

string (date-time)

required

When the endpoint was created.

updated_at

string (date-time)

required

When the endpoint's configuration or status last changed. Its health, failing_since, does not move it.

List an organization's webhook endpoints

GET
/v1/organizations/{organization_id}/webhook-endpoints

Returns the organization's webhook endpoints, enabled and disabled, each with the event types it is sent, its status and when its run of failed deliveries began. A secret is never answered: postOrganizationWebhookEndpoint answers it once.

  • A session token minted for api without a user is asked for no member role on this read; one minted for studio-embedded without a user is the 401 a key alone gets. One that names a user is answered only while that user holds the owner or admin role in the organization, and is a 403 otherwise.
  • The listing is paged, 50 endpoints a page unless limit says otherwise, oldest first. An organization holds 2 unless its agreement says otherwise, 6 at most, so one page holds them all. Send the page's next_cursor back as cursor for the next one; the last page reports next_cursor: null.

Path parameters

organization_id

string (uuid)

in path

required

Identifier of the organization the operation acts on. A publishable key reaches only its own organization: any other identifier is a 403, whether or not it exists, so the parameter cannot be used to probe which organization ids exist.

Query parameters

cursor

string

in query

Where the page starts: the next_cursor the previous page reported at extensions.metadata.pagination, sent back unchanged. Omitted, the listing starts at its first item.

limit

integer (int32)

in query

default: 50

How many items one page holds, between 1 and 100; 50 when omitted, on every listing that pages. extensions.metadata.pagination.limit reports the size the page was served at. A page shorter than limit is not how the end is told: the end is a next_cursor of null. The page is cut after authorization, so it never widens what a caller can read.

Response 200

One page of the organization's webhook endpoints, oldest first. extensions.metadata.pagination.next_cursor asks for the next page, and is null on the last.

extensions

object

required

The envelope's second half, everything the answer carries that is not the answer itself. Here that is metadata.pagination alone: the limit this page was served at, and the next_cursor of the page after it, null on the last.

data

array of WebhookEndpoint

required

Errors 400, 401, 403, 404, 429, 500, 504. See Errors.

curl -s https://api.mountaya.com/v1/organizations/d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b/webhook-endpoints \
  -H "X-API-Key: pk_your_publishable_key" \
  -H "X-Session-Token: sess_your_session_token" | jq '.data'
200
Response
{
  "data": [
    {
      "id": "e4b7a1d9-5c26-4f83-a0e1-7d2c9b6f3a85",
      "organization_id": "d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b",
      "url": "https://hooks.example.com/mountaya",
      "description": "Membership sync",
      "enabled_events": [
        "organization.member.*",
        "organization.invitation.accepted"
      ],
      "status": "enabled",
      "disabled_reason": null,
      "disabled_at": null,
      "failing_since": null,
      "etag": "\"d6\"",
      "created_by": {
        "id": "1b9d4e72-0c35-4a8f-b6e1-5f2c7d904a18"
      },
      "created_at": "2026-11-02T13:05:47Z",
      "updated_at": "2026-11-14T09:12:44Z"
    }
  ],
  "extensions": {
    "metadata": {
      "pagination": {
        "limit": 50,
        "next_cursor": "eyJ2IjoxLCJzIjoiLXVwZGF0ZWRfYXQifQ"
      }
    }
  }
}

Create a webhook endpoint

POST
/v1/organizations/{organization_id}/webhook-endpoints

Creates an endpoint Mountaya delivers the organization's webhook events to: every event of a type its enabled_events names, from the next one recorded on, signed with a secret of its own, answered here once. A create sent twice without an Idempotency-Key makes two endpoints; with one, the second is not answered the first one's endpoint, since that answer carried the secret and is never kept: it is the 409 coded IDEMPOTENCY_ANSWER_UNAVAILABLE. A create sent again with the key, after the first failed with a 5xx once the endpoint was made, is that 409 too, whose extensions.metadata.location names the endpoint made, /v1/organizations/{organization_id}/webhook-endpoints/{webhook_endpoint_id}. This API answers a secret once: an owner or an admin reads that endpoint's again in Mountaya's web application, or deletes it and creates another.

  • Owner or admin only (403 otherwise).
  • url is https, written in printable ASCII, at most 2048 characters, with no credentials before its host and no fragment, its host, port included, at most 259 characters; and that host resolves to a public address: a private, loopback or link-local one is a 400 naming url, and so is one Mountaya cannot resolve. A redirect is never followed.
  • enabled_events names types, families followed by .*, or *. A type or a family the contract does not publish is a 400 naming its position; getWebhookEventTypes lists them.
  • An organization holds 2 endpoints, enabled and disabled, unless its agreement says otherwise, 6 at most: one more is refused at webhook-endpoints, a 429 coded LIMIT_REACHED with no Retry-After. Delete one first, or agree a higher limit. An organization whose limit was lowered below what it holds keeps its endpoints, and creates none until it holds fewer than the limit.
  • It is limited, together with the organization's other endpoint writes this document's introduction lists, to 30 a minute per user and then 300 a minute per organization; past either, the answer is a 429 carrying Retry-After, and nothing is done.
  • Mountaya delivers each event at least once, in no promised order, retrying a failed attempt for about 72 hours. This document's introduction says how a delivery is signed, retried and recorded.

Webhook events organization.webhook_endpoint.created, recorded by the task organization.webhook_endpoint.create.

Path parameters

organization_id

string (uuid)

in path

required

Identifier of the organization the operation acts on. A publishable key reaches only its own organization: any other identifier is a 403, whether or not it exists, so the parameter cannot be used to probe which organization ids exist.

Headers

Idempotency-Key

string

in header

A value the caller chooses once per logical write and sends again, unchanged, on every retry of it, so a write whose answer was lost runs at most once. A UUID is the usual choice; any 1 to 255 printable ASCII characters without a space are accepted. The key is held for 12 hours, for the credential that sent it (the publishable key and the user its session token names) and for this operation.

Body

Where to deliver, and which event types.

url

string (uri)

in body

required

The URL Mountaya delivers to. It is https, written in printable ASCII, at most 2048 characters, with no credentials before its host and no fragment, its host, port included, at most 259 characters; and that host resolves to a public address: a private, loopback or link-local one is a 400 naming url, and so is one that cannot be resolved.

description

string

in body

What the endpoint is for, at most 100 characters, trimmed. Omitted, the endpoint has none.

enabled_events

array of string

in body

required

The event types the endpoint is sent: each a member of WebhookEventType, a family followed by .*, or * for every public type, those added later included. A type or a family the contract does not publish is a 400 naming its position.

Response 201

The endpoint as created, with its secret, shown here once. Location names it, /v1/organizations/{organization_id}/webhook-endpoints/{webhook_endpoint_id}, the path getOrganizationWebhookEndpoint reads it at.

extensions

object

Top-level extensions map for 2xx responses. Mirrors the GraphQL-spec response extensions: a free-form map for response-scoped metadata.

data

WebhookEndpointWithSecret

required

A webhook endpoint as postOrganizationWebhookEndpoint answers it: the endpoint, and the secret its deliveries are signed with. This is the one answer that carries the secret, and it is never kept for the request's Idempotency-Key, so store it before anything else.

Errors 400, 401, 403, 404, 409, 413, 429, 500, 504. See Errors.

curl -s -X POST https://api.mountaya.com/v1/organizations/d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b/webhook-endpoints \
  -H "X-API-Key: pk_your_publishable_key" \
  -H "X-Session-Token: sess_your_session_token" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://hooks.example.com/mountaya",
    "enabled_events": ["organization.member.*"]
  }' | jq '.data.secret'
201
Response
{
  "data": {
    "id": "e4b7a1d9-5c26-4f83-a0e1-7d2c9b6f3a85",
    "organization_id": "d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b",
    "url": "https://hooks.example.com/mountaya",
    "description": "Membership sync",
    "enabled_events": [
      "organization.member.*",
      "organization.invitation.accepted"
    ],
    "status": "enabled",
    "disabled_reason": null,
    "disabled_at": null,
    "failing_since": null,
    "etag": "\"d1\"",
    "created_by": {
      "id": "1b9d4e72-0c35-4a8f-b6e1-5f2c7d904a18"
    },
    "created_at": "2026-11-02T13:05:47Z",
    "updated_at": "2026-11-02T13:05:47Z",
    "secret": "whsk_8f3c2a71b845d0e4c7a6b3f180d92e5a17c4e9b0d36f2a58e1c7b4093d6a2f15"
  }
}

Retrieve a webhook endpoint

GET
/v1/organizations/{organization_id}/webhook-endpoints/{webhook_endpoint_id}

Returns one of the organization's webhook endpoints, as getOrganizationWebhookEndpoints lists it. Its secret is never answered.

  • A session token minted for api without a user is asked for no member role on this read; one minted for studio-embedded without a user is the 401 a key alone gets. One that names a user is answered only while that user holds the owner or admin role in the organization, and is a 403 otherwise.
  • The answer's ETag is the endpoint's etag. Send it as If-Match on patchOrganizationWebhookEndpoint or deleteOrganizationWebhookEndpoint to make the change conditional on nobody having changed the endpoint since.

Path parameters

organization_id

string (uuid)

in path

required

Identifier of the organization the operation acts on. A publishable key reaches only its own organization: any other identifier is a 403, whether or not it exists, so the parameter cannot be used to probe which organization ids exist.

webhook_endpoint_id

string (uuid)

in path

required

Identifier of the webhook endpoint, the id a WebhookEndpoint carries. One that names no endpoint of the organization, another organization's included, is answered 404, so an endpoint id cannot be probed here.

Response 200

The endpoint, without its secret.

extensions

object

Top-level extensions map for 2xx responses. Mirrors the GraphQL-spec response extensions: a free-form map for response-scoped metadata.

data

WebhookEndpoint

required

A webhook endpoint: a URL of the organization's own that Mountaya delivers webhook events to, signed with the endpoint's secret. The secret is answered once, by postOrganizationWebhookEndpoint, and never by a read.

See the WebhookEndpoint object.

Errors 400, 401, 403, 404, 429, 500, 504. See Errors.

curl -s https://api.mountaya.com/v1/organizations/d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b/webhook-endpoints/e4b7a1d9-5c26-4f83-a0e1-7d2c9b6f3a85 \
  -H "X-API-Key: pk_your_publishable_key" \
  -H "X-Session-Token: sess_your_session_token" | jq '.data'
200
Response
{
  "data": {
    "id": "e4b7a1d9-5c26-4f83-a0e1-7d2c9b6f3a85",
    "organization_id": "d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b",
    "url": "https://hooks.example.com/mountaya",
    "description": "Membership sync",
    "enabled_events": [
      "organization.member.*",
      "organization.invitation.accepted"
    ],
    "status": "enabled",
    "disabled_reason": null,
    "disabled_at": null,
    "failing_since": null,
    "etag": "\"d6\"",
    "created_by": {
      "id": "1b9d4e72-0c35-4a8f-b6e1-5f2c7d904a18"
    },
    "created_at": "2026-11-02T13:05:47Z",
    "updated_at": "2026-11-14T09:12:44Z"
  }
}

Update a webhook endpoint

PATCH
/v1/organizations/{organization_id}/webhook-endpoints/{webhook_endpoint_id}

Changes an endpoint's URL, description, event types or status. Each field is optional and an omitted one keeps its value; enabled_events is replaced whole. An empty object changes nothing and answers the endpoint as it stands.

  • Owner or admin only (403 otherwise).
  • url and enabled_events are held to the rules of a new endpoint's, and refused the same way.
  • status disabled stops every delivery to the endpoint, the ones still retrying included, which end canceled. enabled starts them again from the next event recorded, and clears failing_since; the events recorded while it was disabled are not sent on their own, and postOrganizationWebhookDelivery redelivers those of the last 30 days.
  • The secret is not changed here.
  • If-Match makes the change conditional: send the endpoint's etag, and an endpoint changed since is refused with 412, changing nothing.
  • It is limited, together with the organization's other endpoint writes this document's introduction lists, to 30 a minute per user and then 300 a minute per organization; past either, the answer is a 429 carrying Retry-After, and nothing is done.

Webhook events organization.webhook_endpoint.updated, organization.webhook_endpoint.enabled, organization.webhook_endpoint.disabled, recorded by the task organization.webhook_endpoint.update.

Path parameters

organization_id

string (uuid)

in path

required

Identifier of the organization the operation acts on. A publishable key reaches only its own organization: any other identifier is a 403, whether or not it exists, so the parameter cannot be used to probe which organization ids exist.

webhook_endpoint_id

string (uuid)

in path

required

Identifier of the webhook endpoint, the id a WebhookEndpoint carries. One that names no endpoint of the organization, another organization's included, is answered 404, so an endpoint id cannot be probed here.

Headers

Idempotency-Key

string

in header

A value the caller chooses once per logical write and sends again, unchanged, on every retry of it, so a write whose answer was lost runs at most once. A UUID is the usual choice; any 1 to 255 printable ASCII characters without a space are accepted. The key is held for 12 hours, for the credential that sent it (the publishable key and the user its session token names) and for this operation.

If-Match

string

in header

Makes the write conditional on the resource still being the version the caller read: the ETag an earlier answer carried, which is also that resource's etag field, or * for any version. When the resource has changed since, the write is refused with 412 PRECONDITION_FAILED, nothing is changed, and the answer carries the current ETag, so the caller reads the resource again and decides. Omitted, the write is unconditional and the last write wins.

Body

What to change. Send only what is changing.

url

string (uri)

in body

The URL Mountaya delivers to from the next delivery on, held to the rules of a new endpoint's. A delivery still retrying is sent to it.

description

string | null

in body

What the endpoint is for, at most 100 characters, trimmed. null clears it.

enabled_events

array of string

in body

The event types the endpoint is sent, replacing the list whole, as a new endpoint's. The list is read when an event is handed to its deliveries, a moment after it is recorded: an event recorded just before the change may be delivered by either list, and every later one by the new.

status

string

in body

One of: enabled, disabled

disabled stops every delivery to the endpoint, those still retrying included, with disabled_reason requested; enabled starts them again from the next event, and clears failing_since. The events recorded meanwhile are not sent on their own: postOrganizationWebhookDelivery redelivers them.

Response 200

The endpoint after the change, without its secret.

extensions

object

Top-level extensions map for 2xx responses. Mirrors the GraphQL-spec response extensions: a free-form map for response-scoped metadata.

data

WebhookEndpoint

required

A webhook endpoint: a URL of the organization's own that Mountaya delivers webhook events to, signed with the endpoint's secret. The secret is answered once, by postOrganizationWebhookEndpoint, and never by a read.

See the WebhookEndpoint object.

Errors 400, 401, 403, 404, 409, 412, 413, 429, 500, 504. See Errors.

curl -s -X PATCH https://api.mountaya.com/v1/organizations/d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b/webhook-endpoints/e4b7a1d9-5c26-4f83-a0e1-7d2c9b6f3a85 \
  -H "X-API-Key: pk_your_publishable_key" \
  -H "X-Session-Token: sess_your_session_token" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"status": "enabled"}'
200
Response
{
  "data": {
    "id": "e4b7a1d9-5c26-4f83-a0e1-7d2c9b6f3a85",
    "organization_id": "d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b",
    "url": "https://hooks.example.com/mountaya",
    "description": "Membership sync",
    "enabled_events": [
      "organization.member.*",
      "organization.invitation.accepted"
    ],
    "status": "enabled",
    "disabled_reason": null,
    "disabled_at": null,
    "failing_since": null,
    "etag": "\"d6\"",
    "created_by": {
      "id": "1b9d4e72-0c35-4a8f-b6e1-5f2c7d904a18"
    },
    "created_at": "2026-11-02T13:05:47Z",
    "updated_at": "2026-11-14T09:12:44Z"
  }
}

Delete a webhook endpoint

DELETE
/v1/organizations/{organization_id}/webhook-endpoints/{webhook_endpoint_id}

Deletes an endpoint: nothing is delivered to it from then on, and its deliveries still retrying end canceled. Its deliveries already made stay readable for the 13 months deliveries are kept, and getOrganizationWebhookDeliveries and getOrganizationWebhookHealth still narrow to it by its identifier. It frees its place under the organization's webhook-endpoints limit.

  • Owner or admin only (403 otherwise).
  • An endpoint already deleted is a 404; a delete retried with the first one's Idempotency-Key is answered its first 200.
  • If-Match makes the deletion conditional: send the endpoint's etag, and an endpoint changed since is refused with 412, deleting nothing.
  • It is limited, together with the organization's other endpoint writes this document's introduction lists, to 30 a minute per user and then 300 a minute per organization; past either, the answer is a 429 carrying Retry-After, and nothing is done.

Webhook events organization.webhook_endpoint.deleted, recorded by the task organization.webhook_endpoint.delete.

Path parameters

organization_id

string (uuid)

in path

required

Identifier of the organization the operation acts on. A publishable key reaches only its own organization: any other identifier is a 403, whether or not it exists, so the parameter cannot be used to probe which organization ids exist.

webhook_endpoint_id

string (uuid)

in path

required

Identifier of the webhook endpoint, the id a WebhookEndpoint carries. One that names no endpoint of the organization, another organization's included, is answered 404, so an endpoint id cannot be probed here.

Headers

Idempotency-Key

string

in header

A value the caller chooses once per logical write and sends again, unchanged, on every retry of it, so a write whose answer was lost runs at most once. A UUID is the usual choice; any 1 to 255 printable ASCII characters without a space are accepted. The key is held for 12 hours, for the credential that sent it (the publishable key and the user its session token names) and for this operation.

If-Match

string

in header

Makes the write conditional on the resource still being the version the caller read: the ETag an earlier answer carried, which is also that resource's etag field, or * for any version. When the resource has changed since, the write is refused with 412 PRECONDITION_FAILED, nothing is changed, and the answer carries the current ETag, so the caller reads the resource again and decides. Omitted, the write is unconditional and the last write wins.

Response 200

The endpoint is deleted. There is no payload.

extensions

object

Top-level extensions map for 2xx responses. Mirrors the GraphQL-spec response extensions: a free-form map for response-scoped metadata.

data

any | null

required

Errors 400, 401, 403, 404, 409, 412, 429, 500, 504. See Errors.

curl -s -X DELETE https://api.mountaya.com/v1/organizations/d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b/webhook-endpoints/e4b7a1d9-5c26-4f83-a0e1-7d2c9b6f3a85 \
  -H "X-API-Key: pk_your_publishable_key" \
  -H "X-Session-Token: sess_your_session_token" \
  -H "Idempotency-Key: $(uuidgen)"
200
Response
{
  "data": null
}

List an organization's webhook events

GET
/v1/organizations/{organization_id}/webhook-events

Returns every public webhook event recorded in the organization over the 13 months events are kept, whether or not an endpoint was sent it: what its members' acts and Mountaya recorded, before any endpoint subscribes. Each is the envelope a delivery carries, exactly. It is how a receiver that was down past the retries reconciles: list from the last event it processed, and redeliver or read what it missed.

  • A session token minted for api without a user is asked for no member role on this read; one minted for studio-embedded without a user is the 401 a key alone gets. One that names a user is answered only while that user holds the owner or admin role in the organization, and is a 403 otherwise.
  • The filters combine. type keeps one type and family every type of one family; related_object_id the events about one object; request_id the events one API request recorded, by the X-Request-Id its answer carried; actor_type and actor_user_id who made the change; delivery_outcome the events with at least one delivery standing so; start_at and end_at when they were recorded.
  • The listing is paged, 50 events a page unless limit says otherwise, the most recent first. Send the page's next_cursor back as cursor for the next one; the last page reports next_cursor: null.
  • An event is listed within seconds of its change. getOrganizationWebhookEvent reads one with its deliveries.

Path parameters

organization_id

string (uuid)

in path

required

Identifier of the organization the operation acts on. A publishable key reaches only its own organization: any other identifier is a 403, whether or not it exists, so the parameter cannot be used to probe which organization ids exist.

Query parameters

cursor

string

in query

Where the page starts: the next_cursor the previous page reported at extensions.metadata.pagination, sent back unchanged. Omitted, the listing starts at its first item.

limit

integer (int32)

in query

default: 50

How many items one page holds, between 1 and 100; 50 when omitted, on every listing that pages. extensions.metadata.pagination.limit reports the size the page was served at. A page shorter than limit is not how the end is told: the end is a next_cursor of null. The page is cut after authorization, so it never widens what a caller can read.

type

string

in query

Keep only the events of this type.

family

string

in query

Keep only the events of this family, every type of it: organization.member keeps organization.member.created, .updated and .deleted. A family the contract does not publish is a 400.

related_object_id

string

in query

Keep only the events about this object, the related_object.id they carry: a UUID, or an invoice's or a payment method's identifier.

request_id

string

in query

Keep only the events this API request recorded: the X-Request-Id its answer carried, 32 lowercase hexadecimal characters.

actor_type

string

in query

One of: user, key, mountaya

Keep only the events this kind of actor made.

actor_user_id

string (uuid)

in query

Keep only the events this person made.

delivery_outcome

string

in query

One of: pending, retrying, succeeded, exhausted, canceled

Keep only the events with at least one delivery standing so: exhausted lists what an endpoint never received.

start_at

string (date-time)

in query

The first instant covered, inclusive, as an RFC 3339 date-time. Events and deliveries are kept 13 months, so an instant before that covers nothing more. A start_at after end_at is a 400 naming both.

end_at

string (date-time)

in query

The instant the range ends at, exclusive, as an RFC 3339 date-time. Omitted, the range runs to the moment the request is answered.

Response 200

One page of the organization's webhook events, the most recent first. extensions.metadata.pagination.next_cursor asks for the next page, and is null on the last.

extensions

object

required

The envelope's second half, everything the answer carries that is not the answer itself. Here that is metadata.pagination alone: the limit this page was served at, and the next_cursor of the page after it, null on the last.

data

array of WebhookEvent

required

Errors 400, 401, 403, 404, 429, 500, 504. See Errors.

curl -s "https://api.mountaya.com/v1/organizations/d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b/webhook-events?request_id=2c5ed6d8b8f7c706e9a0d5c5144ed90b" \
  -H "X-API-Key: pk_your_publishable_key" \
  -H "X-Session-Token: sess_your_session_token" | jq '.data[].type'
200
Response
{
  "data": [
    {
      "id": "019a8eed-e1ad-7753-b049-b0e20d79577a",
      "object": "webhook_event",
      "type": "organization.member.updated",
      "api_version": "0.8.0",
      "created_at": "2026-11-14T09:12:44Z",
      "organization_id": "d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b",
      "task": "organization.member.update",
      "related_object": {
        "type": "organization.member",
        "id": "7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1"
      },
      "data": {
        "object": {
          "object": "organization.member",
          "user_id": "7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1",
          "role": "contributor",
          "joined_at": "2026-03-11T14:02:09Z"
        },
        "previous_attributes": {
          "role": "viewer"
        }
      },
      "request": {
        "id": "2c5ed6d8b8f7c706e9a0d5c5144ed90b"
      },
      "actor": {
        "type": "user",
        "user_id": "1b9d4e72-0c35-4a8f-b6e1-5f2c7d904a18",
        "key_id": "3b1f9c02-6d4e-4a87-b5c1-70e2af3d8916"
      }
    }
  ],
  "extensions": {
    "metadata": {
      "pagination": {
        "limit": 50,
        "next_cursor": "eyJ2IjoxLCJzIjoiLXVwZGF0ZWRfYXQifQ"
      }
    }
  }
}

Retrieve a webhook event with its deliveries

GET
/v1/organizations/{organization_id}/webhook-events/{event_id}

Returns one webhook event, the envelope its deliveries carried, with the deliveries made of it: one per endpoint it was sent to, per notification email it caused, and per resend or redelivery since, each with its last attempt.

  • delivery_count is how many deliveries were made of the event, and deliveries carries them all up to 100. Past that it carries the 100 most recently started: getOrganizationWebhookDeliveries pages every one of them by event_id.
  • A session token minted for api without a user is asked for no member role on this read; one minted for studio-embedded without a user is the 401 a key alone gets. One that names a user is answered only while that user holds the owner or admin role in the organization, and is a 403 otherwise.
  • An event is kept 13 months; one older is a 404.

Path parameters

organization_id

string (uuid)

in path

required

Identifier of the organization the operation acts on. A publishable key reaches only its own organization: any other identifier is a 403, whether or not it exists, so the parameter cannot be used to probe which organization ids exist.

event_id

string (uuid)

in path

required

Identifier of the webhook event, the id a WebhookEvent carries and the Mountaya-Event-Id header of each of its deliveries. One that names no event of the organization within the 13 months events are kept is answered 404.

Response 200

The event, with its deliveries.

extensions

object

Top-level extensions map for 2xx responses. Mirrors the GraphQL-spec response extensions: a free-form map for response-scoped metadata.

data

WebhookEventWithDeliveries

required

A webhook event with the deliveries made of it: one per endpoint it was sent to, per notification email it caused, and per resend or redelivery since. An event no destination was recorded for carries none.

Errors 400, 401, 403, 404, 429, 500, 504. See Errors.

curl -s https://api.mountaya.com/v1/organizations/d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b/webhook-events/019a8eed-e1ad-7753-b049-b0e20d79577a \
  -H "X-API-Key: pk_your_publishable_key" \
  -H "X-Session-Token: sess_your_session_token" | jq '.data.deliveries'
200
Response
{
  "data": {
    "id": "019a8eed-e1ad-7753-b049-b0e20d79577a",
    "object": "webhook_event",
    "type": "organization.member.updated",
    "api_version": "0.8.0",
    "created_at": "2026-11-14T09:12:44Z",
    "organization_id": "d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b",
    "task": "organization.member.update",
    "related_object": {
      "type": "organization.member",
      "id": "7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1"
    },
    "data": {
      "object": {
        "object": "organization.member",
        "user_id": "7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1",
        "role": "contributor",
        "joined_at": "2026-03-11T14:02:09Z"
      },
      "previous_attributes": {
        "role": "viewer"
      }
    },
    "request": {
      "id": "2c5ed6d8b8f7c706e9a0d5c5144ed90b"
    },
    "actor": {
      "type": "user",
      "user_id": "1b9d4e72-0c35-4a8f-b6e1-5f2c7d904a18",
      "key_id": "3b1f9c02-6d4e-4a87-b5c1-70e2af3d8916"
    },
    "delivery_count": 2,
    "deliveries": [
      {
        "id": "019a8eee-07c2-7a1d-8f43-5b9e2c6d1a07",
        "event_id": "019a8eed-e1ad-7753-b049-b0e20d79577a",
        "event_type": "organization.member.updated",
        "destination": "endpoint",
        "webhook_endpoint_id": "e4b7a1d9-5c26-4f83-a0e1-7d2c9b6f3a85",
        "trigger": "event",
        "outcome": "succeeded",
        "attempt_count": 1,
        "last_attempt_at": "2026-11-14T09:12:45Z",
        "next_attempt_at": null,
        "response_status": 204,
        "created_at": "2026-11-14T09:12:45Z"
      },
      {
        "id": "019a8eee-07c9-7b52-a1d4-3e7f0c9b2d61",
        "event_id": "019a8eed-e1ad-7753-b049-b0e20d79577a",
        "event_type": "organization.member.updated",
        "destination": "email",
        "recipient": {
          "user_id": "7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1",
          "email": "camille@example.com"
        },
        "notification": "member-role-changed",
        "trigger": "event",
        "outcome": "succeeded",
        "attempt_count": 1,
        "last_attempt_at": "2026-11-14T09:12:47Z",
        "next_attempt_at": null,
        "created_at": "2026-11-14T09:12:45Z"
      }
    ]
  }
}

List an organization's webhook deliveries

GET
/v1/organizations/{organization_id}/webhook-deliveries

Returns every delivery of the organization's webhook events over the 13 months deliveries are kept: to its endpoints, and the notification emails its events caused, each with where it stands and its last attempt. An email delivery names its recipient and its notification, never what the email said.

  • A session token minted for api without a user is asked for no member role on this read; one minted for studio-embedded without a user is the 401 a key alone gets. One that names a user is answered only while that user holds the owner or admin role in the organization, and is a 403 otherwise.
  • The filters combine: webhook_endpoint_id one endpoint, event_id one event, destination endpoints or emails, outcome where a delivery stands, failure_class and failure_kind how its last attempt failed, event_type the type delivered, trigger_id the deliveries one resend, test or redelivery started, and start_at and end_at when the deliveries started: a delivery is listed by its first attempt, wherever its later ones fall.
  • The listing is paged, 50 deliveries a page unless limit says otherwise, the most recently started first. Send the page's next_cursor back as cursor for the next one; the last page reports next_cursor: null.

Path parameters

organization_id

string (uuid)

in path

required

Identifier of the organization the operation acts on. A publishable key reaches only its own organization: any other identifier is a 403, whether or not it exists, so the parameter cannot be used to probe which organization ids exist.

Query parameters

cursor

string

in query

Where the page starts: the next_cursor the previous page reported at extensions.metadata.pagination, sent back unchanged. Omitted, the listing starts at its first item.

limit

integer (int32)

in query

default: 50

How many items one page holds, between 1 and 100; 50 when omitted, on every listing that pages. extensions.metadata.pagination.limit reports the size the page was served at. A page shorter than limit is not how the end is told: the end is a next_cursor of null. The page is cut after authorization, so it never widens what a caller can read.

webhook_endpoint_id

string (uuid)

in query

Keep only what concerns this webhook endpoint of the organization: one it holds, or one it deleted, whose deliveries stay readable for the 13 months they are kept. One that names no endpoint the organization held in those 13 months is a 400 naming it. Omitted, every destination is covered, the notification emails included.

event_id

string (uuid)

in query

Keep only the deliveries of this event, by the id getOrganizationWebhookEvents lists: every one of them, where getOrganizationWebhookEvent carries the 100 most recently started.

destination

string

in query

One of: endpoint, email

Keep only the deliveries to this kind of destination: email keeps the notification emails.

outcome

string

in query

One of: pending, retrying, succeeded, exhausted, canceled

Keep only the deliveries standing so.

failure_class

string

in query

One of: receiver, mountaya

Keep only the deliveries whose last attempt failed, and whose failure is this one's.

failure_kind

string

in query

One of: timeout, connection, tls, redirect, http-status, refused-address, bounced, unknown-mailbox, blocklisted, spam, internal

Keep only the deliveries whose last attempt failed this way.

event_type

string

in query

Keep only the deliveries of events of this type.

trigger_id

string (uuid)

in query

Keep only the deliveries one resend, test or redelivery started, by the id postOrganizationWebhookDelivery answered.

start_at

string (date-time)

in query

The first instant covered, inclusive, as an RFC 3339 date-time. Events and deliveries are kept 13 months, so an instant before that covers nothing more. A start_at after end_at is a 400 naming both.

end_at

string (date-time)

in query

The instant the range ends at, exclusive, as an RFC 3339 date-time. Omitted, the range runs to the moment the request is answered.

Response 200

One page of the organization's webhook deliveries, the most recently started first. extensions.metadata.pagination.next_cursor asks for the next page, and is null on the last.

extensions

object

required

The envelope's second half, everything the answer carries that is not the answer itself. Here that is metadata.pagination alone: the limit this page was served at, and the next_cursor of the page after it, null on the last.

data

array of WebhookDelivery

required

Errors 400, 401, 403, 404, 429, 500, 504. See Errors.

curl -s "https://api.mountaya.com/v1/organizations/d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b/webhook-deliveries?webhook_endpoint_id=e4b7a1d9-5c26-4f83-a0e1-7d2c9b6f3a85&outcome=retrying" \
  -H "X-API-Key: pk_your_publishable_key" \
  -H "X-Session-Token: sess_your_session_token" | jq '.data'
200
Response
{
  "data": [
    {
      "id": "019a8eee-07c2-7a1d-8f43-5b9e2c6d1a07",
      "event_id": "019a8eed-e1ad-7753-b049-b0e20d79577a",
      "event_type": "organization.member.updated",
      "destination": "endpoint",
      "webhook_endpoint_id": "e4b7a1d9-5c26-4f83-a0e1-7d2c9b6f3a85",
      "trigger": "event",
      "outcome": "retrying",
      "attempt_count": 2,
      "last_attempt_at": "2026-11-14T09:13:46Z",
      "next_attempt_at": "2026-11-14T09:18:46Z",
      "failure_kind": "http-status",
      "failure_class": "receiver",
      "response_status": 503,
      "created_at": "2026-11-14T09:12:45Z"
    }
  ],
  "extensions": {
    "metadata": {
      "pagination": {
        "limit": 50,
        "next_cursor": "eyJ2IjoxLCJzIjoiLXVwZGF0ZWRfYXQifQ"
      }
    }
  }
}

Resend an event, send a test event, or redeliver an endpoint's events

POST
/v1/organizations/{organization_id}/webhook-deliveries

Starts deliveries to one of the organization's endpoints, which run after the answer. The body names the endpoint and exactly one of three things:

  • event_id, a resend: one event recorded in the last 30 days, delivered again on the delivery schedule, whether or not the endpoint was sent it the first time.
  • test, a test: a test event of the type named, its payload this contract's example for the type with an id of its own, delivered once without retries. It is recorded nowhere else and listed by no getOrganizationWebhookEvents.
  • since, a redelivery: every event recorded from that instant on, at most 30 days ago, whose type the endpoint is sent, delivered again oldest first at a paced rate. Use it after an outage outlasted the retries, or after enabling an endpoint again, from the failing_since the endpoint carried before it was enabled. One redelivery runs at a time for an endpoint.

Path parameters

organization_id

string (uuid)

in path

required

Identifier of the organization the operation acts on. A publishable key reaches only its own organization: any other identifier is a 403, whether or not it exists, so the parameter cannot be used to probe which organization ids exist.

Headers

Idempotency-Key

string

in header

A value the caller chooses once per logical write and sends again, unchanged, on every retry of it, so a write whose answer was lost runs at most once. A UUID is the usual choice; any 1 to 255 printable ASCII characters without a space are accepted. The key is held for 12 hours, for the credential that sent it (the publishable key and the user its session token names) and for this operation.

Body

The endpoint, and the event, the test or the instant to redeliver from.

webhook_endpoint_id

string (uuid)

in body

required

Identifier of the endpoint to deliver to. A disabled one is a 409: enable it first.

event_id

string (uuid)

in body

A resend: the event to deliver again, recorded in the last 30 days, whether or not the endpoint was sent it the first time or its enabled_events names its type. It starts one delivery, its own attempts on the delivery schedule.

test

object

in body

A test: a test event of the type named, delivered once without retries.

since

string (date-time)

in body

A redelivery: every event recorded from this instant on, at most 30 days ago, whose type the endpoint's enabled_events names, delivered again oldest first at a paced rate, each its own delivery carrying the redelivery's trigger_id. An instant further back, or one still to come, is a 400 naming it.

Response 202

The resend, test or redelivery started. Its deliveries run after the answer, each carrying its id as trigger_id; a resend's or a test's one delivery is delivery_id.

extensions

object

Top-level extensions map for 2xx responses. Mirrors the GraphQL-spec response extensions: a free-form map for response-scoped metadata.

data

WebhookDeliveryTrigger

required

A resend, a test or a redelivery postOrganizationWebhookDelivery started. The deliveries it starts run after the answer, and each carries its id as trigger_id, which getOrganizationWebhookDeliveries filters on.

Errors 400, 401, 403, 404, 409, 413, 429, 500, 504. See Errors.

curl -s -X POST https://api.mountaya.com/v1/organizations/d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b/webhook-deliveries \
  -H "X-API-Key: pk_your_publishable_key" \
  -H "X-Session-Token: sess_your_session_token" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_endpoint_id": "e4b7a1d9-5c26-4f83-a0e1-7d2c9b6f3a85",
    "event_id": "019a8eed-e1ad-7753-b049-b0e20d79577a"
  }'
202
Response
{
  "data": {
    "id": "019a8ef1-3b6d-7c20-9a4e-1f8d2c7b5e93",
    "kind": "resend",
    "webhook_endpoint_id": "e4b7a1d9-5c26-4f83-a0e1-7d2c9b6f3a85",
    "event_id": "019a8eed-e1ad-7753-b049-b0e20d79577a",
    "delivery_id": "019a8ef1-3b70-7d14-8b2a-6c9e1f4d3a58",
    "created_at": "2026-11-14T10:02:11Z"
  }
}

Retrieve a webhook delivery with its attempts

GET
/v1/organizations/{organization_id}/webhook-deliveries/{delivery_id}

Returns one delivery with every attempt made of it: when each was due and made, how it ended and whose a failure was, and for an endpoint the status it answered and the first 2 KiB of its answer. A notification email's delivery names its recipient and its notification, never what the email said.

  • A session token minted for api without a user is asked for no member role on this read; one minted for studio-embedded without a user is the 401 a key alone gets. One that names a user is answered only while that user holds the owner or admin role in the organization, and is a 403 otherwise.
  • A delivery is kept 13 months; one older is a 404.

Path parameters

organization_id

string (uuid)

in path

required

Identifier of the organization the operation acts on. A publishable key reaches only its own organization: any other identifier is a 403, whether or not it exists, so the parameter cannot be used to probe which organization ids exist.

delivery_id

string (uuid)

in path

required

Identifier of the delivery, the id a WebhookDelivery carries. One that names no delivery of the organization within the 13 months deliveries are kept is answered 404.

Response 200

The delivery, with its attempts.

extensions

object

Top-level extensions map for 2xx responses. Mirrors the GraphQL-spec response extensions: a free-form map for response-scoped metadata.

data

WebhookDeliveryWithAttempts

required

A delivery with every attempt made of it, the first one first.

Errors 400, 401, 403, 404, 429, 500, 504. See Errors.

curl -s https://api.mountaya.com/v1/organizations/d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b/webhook-deliveries/019a8eee-07c2-7a1d-8f43-5b9e2c6d1a07 \
  -H "X-API-Key: pk_your_publishable_key" \
  -H "X-Session-Token: sess_your_session_token" | jq '.data.attempts'
200
Response
{
  "data": {
    "id": "019a8eee-07c2-7a1d-8f43-5b9e2c6d1a07",
    "event_id": "019a8eed-e1ad-7753-b049-b0e20d79577a",
    "event_type": "organization.member.updated",
    "destination": "endpoint",
    "webhook_endpoint_id": "e4b7a1d9-5c26-4f83-a0e1-7d2c9b6f3a85",
    "trigger": "event",
    "outcome": "retrying",
    "attempt_count": 2,
    "last_attempt_at": "2026-11-14T09:13:46Z",
    "next_attempt_at": "2026-11-14T09:18:46Z",
    "failure_kind": "http-status",
    "failure_class": "receiver",
    "response_status": 503,
    "created_at": "2026-11-14T09:12:45Z",
    "attempts": [
      {
        "attempt": 1,
        "outcome": "failed",
        "failure_kind": "timeout",
        "failure_class": "receiver",
        "scheduled_at": "2026-11-14T09:12:45Z",
        "attempted_at": "2026-11-14T09:12:45Z",
        "duration_ms": 10000
      },
      {
        "attempt": 2,
        "outcome": "failed",
        "failure_kind": "http-status",
        "failure_class": "receiver",
        "scheduled_at": "2026-11-14T09:13:45Z",
        "attempted_at": "2026-11-14T09:13:46Z",
        "duration_ms": 212,
        "response_status": 503,
        "response_body": "Service Unavailable"
      }
    ]
  }
}

Retrieve the reliability of an organization's webhooks

GET
/v1/organizations/{organization_id}/webhook-health

Returns how reliably the organization's webhook events were delivered over a window: as totals, as a series of hours or days, and one line per destination. It keeps Mountaya's service availability apart from each endpoint's success, since every failed attempt is classed as the receiver's or as Mountaya's.

  • A session token minted for api without a user is asked for no member role on this read; one minted for studio-embedded without a user is the 401 a key alone gets. One that names a user is answered only while that user holds the owner or admin role in the organization, and is a 403 otherwise.
  • window asks for the last 24 hours or 7 days, an hour at a time, or the last 30 days, a day at a time, ending at the hour the request is answered in. Omitted with no range, it is 24h.
  • start_at and end_at ask for a range instead, at most 92 days within the 13 months deliveries are kept: an hour at a time up to 7 days, a day at a time beyond. window beside either is a 400.
  • webhook_endpoint_id narrows the report to one endpoint; omitted, it covers every endpoint and the notification emails, each a destination line of its own.
  • availability is Mountaya's: the share of the attempts due that were made on schedule with no failure of Mountaya's. The success rates are the endpoints': how often a delivery succeeded at its first attempt, and at any.
  • The figures are a series over the window, not a listing, so they are not paged.

Path parameters

organization_id

string (uuid)

in path

required

Identifier of the organization the operation acts on. A publishable key reaches only its own organization: any other identifier is a 403, whether or not it exists, so the parameter cannot be used to probe which organization ids exist.

Query parameters

webhook_endpoint_id

string (uuid)

in query

Keep only what concerns this webhook endpoint of the organization: one it holds, or one it deleted, whose deliveries stay readable for the 13 months they are kept. One that names no endpoint the organization held in those 13 months is a 400 naming it. Omitted, every destination is covered, the notification emails included.

window

string

in query

One of: 24h, 7d, 30d

The window to report on, ending at the hour the request is answered in. Omitted with no range, it is 24h; beside start_at or end_at it is a 400.

start_at

string (date-time)

in query

The first instant covered, inclusive, as an RFC 3339 date-time. Events and deliveries are kept 13 months, so an instant before that covers nothing more. A start_at after end_at is a 400 naming both.

end_at

string (date-time)

in query

The instant the range ends at, exclusive, as an RFC 3339 date-time. Omitted, the range runs to the moment the request is answered.

Response 200

The reliability report.

extensions

object

Top-level extensions map for 2xx responses. Mirrors the GraphQL-spec response extensions: a free-form map for response-scoped metadata.

data

WebhookHealth

required

The reliability of an organization's webhooks over a span of time: Mountaya's service availability apart from each endpoint's success, as totals, as a series of hours or days, and one line per destination. It covers the organization's endpoints and its notification emails, or one endpoint.

Errors 400, 401, 403, 404, 429, 500, 504. See Errors.

curl -s "https://api.mountaya.com/v1/organizations/d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b/webhook-health?window=7d" \
  -H "X-API-Key: pk_your_publishable_key" \
  -H "X-Session-Token: sess_your_session_token" | jq '.data.totals'
200
Response
{
  "data": {
    "start_at": "2026-11-13T10:00:00Z",
    "end_at": "2026-11-14T10:00:00Z",
    "granularity": "hour",
    "totals": {
      "events_recorded": 1284,
      "attempts_due": 1312,
      "attempts_made": 1312,
      "availability": 1,
      "dispatch_delay_p50_ms": 410,
      "dispatch_delay_p95_ms": 1730,
      "dispatched_within_60s": 1,
      "first_attempt_success_rate": 0.982,
      "eventual_success_rate": 1,
      "response_time_p50_ms": 182,
      "response_time_p95_ms": 640,
      "deliveries_succeeded": 1290,
      "deliveries_pending": 2,
      "deliveries_exhausted": 0,
      "deliveries_canceled": 0,
      "failures": [
        {
          "failure_kind": "http-status",
          "failure_class": "receiver",
          "count": 14
        },
        {
          "failure_kind": "timeout",
          "failure_class": "receiver",
          "count": 6
        }
      ]
    },
    "series": [
      {
        "start_at": "2026-11-13T10:00:00Z",
        "events_recorded": 58,
        "attempts_due": 60,
        "attempts_made": 60,
        "availability": 1,
        "dispatch_delay_p50_ms": 395,
        "dispatch_delay_p95_ms": 1210,
        "dispatched_within_60s": 1,
        "first_attempt_success_rate": 0.966,
        "eventual_success_rate": 1,
        "response_time_p50_ms": 176,
        "response_time_p95_ms": 598,
        "deliveries_succeeded": 58,
        "deliveries_pending": 0,
        "deliveries_exhausted": 0,
        "deliveries_canceled": 0,
        "failures": [
          {
            "failure_kind": "http-status",
            "failure_class": "receiver",
            "count": 2
          }
        ]
      },
      {
        "start_at": "2026-11-14T09:00:00Z",
        "events_recorded": 58,
        "attempts_due": 60,
        "attempts_made": 60,
        "availability": 1,
        "dispatch_delay_p50_ms": 395,
        "dispatch_delay_p95_ms": 1210,
        "dispatched_within_60s": 1,
        "first_attempt_success_rate": 0.966,
        "eventual_success_rate": 1,
        "response_time_p50_ms": 176,
        "response_time_p95_ms": 598,
        "deliveries_succeeded": 58,
        "deliveries_pending": 0,
        "deliveries_exhausted": 0,
        "deliveries_canceled": 0,
        "failures": [
          {
            "failure_kind": "http-status",
            "failure_class": "receiver",
            "count": 2
          }
        ]
      }
    ],
    "destinations": [
      {
        "destination": "endpoint",
        "webhook_endpoint_id": "e4b7a1d9-5c26-4f83-a0e1-7d2c9b6f3a85",
        "status": "enabled",
        "failing_since": null,
        "last_success_at": "2026-11-14T09:58:12Z",
        "attempts_made": 1240,
        "first_attempt_success_rate": 0.982,
        "eventual_success_rate": 1,
        "deliveries_exhausted": 0
      },
      {
        "destination": "email",
        "last_success_at": "2026-11-14T09:12:47Z",
        "attempts_made": 44,
        "first_attempt_success_rate": 1,
        "eventual_success_rate": 1,
        "deliveries_exhausted": 0
      }
    ]
  }
}

List the public webhook event types

Returns every public webhook event type with its family and what records it: the members of WebhookEventType, which an endpoint's enabled_events names. The catalog is the same for every organization, and this document's webhooks describes each type's payload.

  • A session token minted for api without a user is asked for no member role on this read; one minted for studio-embedded without a user is the 401 a key alone gets. One that names a user is answered only while that user holds the owner or admin role in the key's organization, and is a 403 otherwise.
  • The catalog is a set of a size Mountaya decides, so it is not paged.

Response 200

Every public webhook event type, ordered by type.

extensions

object

Top-level extensions map for 2xx responses. Mirrors the GraphQL-spec response extensions: a free-form map for response-scoped metadata.

data

array of WebhookEventCatalogEntry

required

Errors 400, 401, 403, 429, 500, 504. See Errors.

curl -s https://api.mountaya.com/v1/webhook-event-types \
  -H "X-API-Key: pk_your_publishable_key" \
  -H "X-Session-Token: sess_your_session_token" | jq '.data[].type'
200
Response
{
  "data": [
    {
      "type": "organization.member.updated",
      "family": "organization.member",
      "summary": "A member's role changed.",
      "description": "A member's role changed: through `patchOrganizationMember`, or when ownership was handed on, which records one for each of the two members."
    }
  ]
}