> For the complete documentation index, see [llms.txt](https://developers.make.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.make.com/api-documentation/api-reference/event-subscriptions.md).

# Event Subscriptions

The following endpoints let you manage event subscriptions, which send Make events, such as a scenario being created, to your HTTPS endpoint, and inspect and resend their deliveries.

## List event types

> Lists the event types a subscription can receive, with the JSON Schema of each payload version. Use the \`type\` values in a subscription's \`events.types\`.\
> \
> Requires the \`event-subscriptions:read\` scope.<br>

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Event subscriptions","description":"The following endpoints let you manage event subscriptions, which send Make events, such as a scenario being created, to your HTTPS endpoint, and inspect and resend their deliveries."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["event-subscriptions:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/event-subscriptions/v1/organizations/{organizationId}/event-types":{"get":{"operationId":"listEventSubscriptionEventTypes","tags":["Event subscriptions"],"summary":"List event types","description":"Lists the event types a subscription can receive, with the JSON Schema of each payload version. Use the `type` values in a subscription's `events.types`.\n\nRequires the `event-subscriptions:read` scope.\n","parameters":[{"name":"organizationId","in":"path","required":true,"description":"The ID of the organization that owns the event subscriptions.","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"The event types available to subscriptions.","content":{"application/json":{"schema":{"type":"object","required":["eventTypes"],"properties":{"eventTypes":{"type":"array","items":{"type":"object","required":["type","supportsTeamSelection","defaultPayloadVersion","payloads"],"properties":{"type":{"type":"string"},"supportsTeamSelection":{"type":"boolean","description":"If `true`, a subscription's `teams` selection filters this event type."},"defaultPayloadVersion":{"type":"integer","minimum":1,"description":"The version new subscriptions receive. Existing subscriptions keep their version."},"payloads":{"type":"array","items":{"type":"object","required":["version","schema"],"properties":{"version":{"type":"integer","minimum":1},"schema":{"type":"object","additionalProperties":true,"description":"JSON Schema of the event's `data` at this payload version."}}}}}}}}}}}},"400":{"description":"A parameter or the request body is invalid (`VALIDATION_FAILED` or `INVALID_URL`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"401":{"description":"Authentication failed, the token lacks the required scope, or an organization-bound token was used for another organization (`IM001` or `SC401`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"403":{"description":"The user lacks the Event subscriptions permission this action needs in the organization (`FORBIDDEN`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"500":{"description":"An unexpected error occurred (`INTERNAL_ERROR`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"503":{"description":"A required service is temporarily unavailable (`SERVICE_UNAVAILABLE`). Retry the request.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}}}}}}}
```

## List event subscriptions

> Lists the event subscriptions of the organization. Unknown query parameters are rejected with \`400\`.\
> \
> Requires the \`event-subscriptions:read\` scope.<br>

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Event subscriptions","description":"The following endpoints let you manage event subscriptions, which send Make events, such as a scenario being created, to your HTTPS endpoint, and inspect and resend their deliveries."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["event-subscriptions:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/event-subscriptions/v1/organizations/{organizationId}/subscriptions":{"get":{"operationId":"listEventSubscriptions","tags":["Event subscriptions"],"summary":"List event subscriptions","description":"Lists the event subscriptions of the organization. Unknown query parameters are rejected with `400`.\n\nRequires the `event-subscriptions:read` scope.\n","parameters":[{"name":"organizationId","in":"path","required":true,"description":"The ID of the organization that owns the event subscriptions.","schema":{"type":"integer","minimum":1}},{"name":"pg[limit]","in":"query","description":"The maximum number of subscriptions to return.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"pg[offset]","in":"query","description":"The number of subscriptions to skip.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"pg[sortBy]","in":"query","description":"The field to sort subscriptions by.","schema":{"type":"string","enum":["createdAt","name"],"default":"createdAt"}},{"name":"pg[sortDir]","in":"query","description":"The sort direction.","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"pg[returnTotalCount]","in":"query","description":"If `true`, the response includes `pg.totalCount`, the number of subscriptions that match the filter.","schema":{"type":"boolean","default":false}},{"name":"status","in":"query","description":"Return only subscriptions in this state.","schema":{"type":"string","enum":["active","inactive","suspended"],"description":"`active` receives events, `inactive` was disabled, and `suspended` stopped sending after repeated failed deliveries until it is enabled again."}}],"responses":{"200":{"description":"A page of the organization's event subscriptions.","content":{"application/json":{"schema":{"type":"object","required":["subscriptions","pg"],"properties":{"subscriptions":{"type":"array","items":{"type":"object","required":["id","organizationId","name","url","status","events","teams","createdAt","updatedAt"],"properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"integer"},"name":{"type":"string"},"url":{"type":"string"},"status":{"type":"object","required":["state","reason"],"properties":{"state":{"type":"string","enum":["active","inactive","suspended"],"description":"`active` receives events, `inactive` was disabled, and `suspended` stopped sending after repeated failed deliveries until it is enabled again."},"reason":{"type":"string","nullable":true,"description":"Why the subscription is `suspended`, and `null` for other states. New reasons may be added, so accept unknown values."}}},"events":{"type":"object","required":["mode","payloadVersions"],"properties":{"mode":{"type":"string","enum":["all","selected"]},"types":{"type":"array","description":"Present when `mode` is `selected`.","items":{"type":"string"}},"payloadVersions":{"type":"object","description":"The payload version this subscription receives for each subscribed event type. Read-only.","additionalProperties":{"type":"integer","minimum":1}}}},"teams":{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["all","selected"]},"ids":{"type":"array","description":"Present when `mode` is `selected`.","items":{"type":"integer"}}}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}}},"pg":{"type":"object","required":["limit","offset","sortBy","sortDir"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"sortBy":{"type":"string","enum":["createdAt","name"]},"sortDir":{"type":"string","enum":["asc","desc"]},"totalCount":{"type":"integer","description":"Present when `pg[returnTotalCount]` is `true`."}}}}}}}},"400":{"description":"A parameter or the request body is invalid (`VALIDATION_FAILED` or `INVALID_URL`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"401":{"description":"Authentication failed, the token lacks the required scope, or an organization-bound token was used for another organization (`IM001` or `SC401`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"403":{"description":"The user lacks the Event subscriptions permission this action needs in the organization (`FORBIDDEN`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"500":{"description":"An unexpected error occurred (`INTERNAL_ERROR`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"503":{"description":"A required service is temporarily unavailable (`SERVICE_UNAVAILABLE`). Retry the request.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}}}}}}}
```

## Create an event subscription

> Creates an event subscription that sends the selected events to \`url\`.\
> \
> The response contains the \`signingSecret\` used to sign every delivery. Store it to verify that deliveries come from Make.\
> \
> Returns \`403\` with \`SUBSCRIPTION\_LIMIT\_REACHED\` when the organization has reached the number of subscriptions its plan allows.\
> \
> Requires the \`event-subscriptions:write\` scope.<br>

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Event subscriptions","description":"The following endpoints let you manage event subscriptions, which send Make events, such as a scenario being created, to your HTTPS endpoint, and inspect and resend their deliveries."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["event-subscriptions:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/event-subscriptions/v1/organizations/{organizationId}/subscriptions":{"post":{"operationId":"createEventSubscription","tags":["Event subscriptions"],"summary":"Create an event subscription","description":"Creates an event subscription that sends the selected events to `url`.\n\nThe response contains the `signingSecret` used to sign every delivery. Store it to verify that deliveries come from Make.\n\nReturns `403` with `SUBSCRIPTION_LIMIT_REACHED` when the organization has reached the number of subscriptions its plan allows.\n\nRequires the `event-subscriptions:write` scope.\n","parameters":[{"name":"organizationId","in":"path","required":true,"description":"The ID of the organization that owns the event subscriptions.","schema":{"type":"integer","minimum":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name","url","events"],"properties":{"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"\\S","description":"The name of the subscription. It must contain at least one non-whitespace character."},"url":{"type":"string","minLength":1,"description":"The HTTPS endpoint that receives the events. It must be publicly reachable and must not contain a username or password."},"events":{"description":"Which event types the subscription receives. `all` also includes event types added later.","oneOf":[{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"type":"string","enum":["all"]}}},{"type":"object","additionalProperties":false,"required":["mode","types"],"properties":{"mode":{"type":"string","enum":["selected"]},"types":{"type":"array","minItems":1,"maxItems":100,"uniqueItems":true,"description":"Event types returned by List event types.","items":{"type":"string","minLength":1}}}}]},"teams":{"description":"Which teams' events the subscription receives. Applies only to event types with `supportsTeamSelection`. Defaults to all teams.","oneOf":[{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"type":"string","enum":["all"]}}},{"type":"object","additionalProperties":false,"required":["mode","ids"],"properties":{"mode":{"type":"string","enum":["selected"]},"ids":{"type":"array","minItems":1,"maxItems":1000,"uniqueItems":true,"items":{"type":"integer","minimum":1,"maximum":2147483647}}}}]},"enabled":{"type":"boolean","default":true,"description":"If `false`, the subscription is created inactive and receives no events until it is enabled."}}}}}},"responses":{"200":{"description":"The created subscription and its signing secret.","content":{"application/json":{"schema":{"type":"object","required":["subscription","signingSecret"],"properties":{"subscription":{"type":"object","required":["id","organizationId","name","url","status","events","teams","createdAt","updatedAt"],"properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"integer"},"name":{"type":"string"},"url":{"type":"string"},"status":{"type":"object","required":["state","reason"],"properties":{"state":{"type":"string","enum":["active","inactive","suspended"],"description":"`active` receives events, `inactive` was disabled, and `suspended` stopped sending after repeated failed deliveries until it is enabled again."},"reason":{"type":"string","nullable":true,"description":"Why the subscription is `suspended`, and `null` for other states. New reasons may be added, so accept unknown values."}}},"events":{"type":"object","required":["mode","payloadVersions"],"properties":{"mode":{"type":"string","enum":["all","selected"]},"types":{"type":"array","description":"Present when `mode` is `selected`.","items":{"type":"string"}},"payloadVersions":{"type":"object","description":"The payload version this subscription receives for each subscribed event type. Read-only.","additionalProperties":{"type":"integer","minimum":1}}}},"teams":{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["all","selected"]},"ids":{"type":"array","description":"Present when `mode` is `selected`.","items":{"type":"integer"}}}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"signingSecret":{"type":"string","description":"The secret used to sign every delivery to this subscription. Store it to verify the deliveries."}}}}}},"400":{"description":"A parameter or the request body is invalid (`VALIDATION_FAILED` or `INVALID_URL`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"401":{"description":"Authentication failed, the token lacks the required scope, or an organization-bound token was used for another organization (`IM001` or `SC401`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"403":{"description":"The user lacks the Event subscriptions permission this action needs in the organization (`FORBIDDEN`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"500":{"description":"An unexpected error occurred (`INTERNAL_ERROR`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"503":{"description":"A required service is temporarily unavailable (`SERVICE_UNAVAILABLE`). Retry the request.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}}}}}}}
```

## Get an event subscription

> Gets an event subscription and its current status.\
> \
> Requires the \`event-subscriptions:read\` scope.<br>

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Event subscriptions","description":"The following endpoints let you manage event subscriptions, which send Make events, such as a scenario being created, to your HTTPS endpoint, and inspect and resend their deliveries."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["event-subscriptions:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/event-subscriptions/v1/organizations/{organizationId}/subscriptions/{subscriptionId}":{"get":{"operationId":"getEventSubscription","tags":["Event subscriptions"],"summary":"Get an event subscription","description":"Gets an event subscription and its current status.\n\nRequires the `event-subscriptions:read` scope.\n","parameters":[{"name":"organizationId","in":"path","required":true,"description":"The ID of the organization that owns the event subscriptions.","schema":{"type":"integer","minimum":1}},{"name":"subscriptionId","in":"path","required":true,"description":"The ID of the event subscription.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The event subscription.","content":{"application/json":{"schema":{"type":"object","required":["subscription"],"properties":{"subscription":{"type":"object","required":["id","organizationId","name","url","status","events","teams","createdAt","updatedAt"],"properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"integer"},"name":{"type":"string"},"url":{"type":"string"},"status":{"type":"object","required":["state","reason"],"properties":{"state":{"type":"string","enum":["active","inactive","suspended"],"description":"`active` receives events, `inactive` was disabled, and `suspended` stopped sending after repeated failed deliveries until it is enabled again."},"reason":{"type":"string","nullable":true,"description":"Why the subscription is `suspended`, and `null` for other states. New reasons may be added, so accept unknown values."}}},"events":{"type":"object","required":["mode","payloadVersions"],"properties":{"mode":{"type":"string","enum":["all","selected"]},"types":{"type":"array","description":"Present when `mode` is `selected`.","items":{"type":"string"}},"payloadVersions":{"type":"object","description":"The payload version this subscription receives for each subscribed event type. Read-only.","additionalProperties":{"type":"integer","minimum":1}}}},"teams":{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["all","selected"]},"ids":{"type":"array","description":"Present when `mode` is `selected`.","items":{"type":"integer"}}}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}}}}}}},"400":{"description":"A parameter or the request body is invalid (`VALIDATION_FAILED` or `INVALID_URL`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"401":{"description":"Authentication failed, the token lacks the required scope, or an organization-bound token was used for another organization (`IM001` or `SC401`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"403":{"description":"The user lacks the Event subscriptions permission this action needs in the organization (`FORBIDDEN`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"404":{"description":"The subscription does not exist in this organization (`SUBSCRIPTION_NOT_FOUND`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"500":{"description":"An unexpected error occurred (`INTERNAL_ERROR`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"503":{"description":"A required service is temporarily unavailable (`SERVICE_UNAVAILABLE`). Retry the request.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}}}}}}}
```

## Delete an event subscription

> Deletes the event subscription. It stops receiving events immediately.\
> \
> Requires the \`event-subscriptions:write\` scope.<br>

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Event subscriptions","description":"The following endpoints let you manage event subscriptions, which send Make events, such as a scenario being created, to your HTTPS endpoint, and inspect and resend their deliveries."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["event-subscriptions:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/event-subscriptions/v1/organizations/{organizationId}/subscriptions/{subscriptionId}":{"delete":{"operationId":"deleteEventSubscription","tags":["Event subscriptions"],"summary":"Delete an event subscription","description":"Deletes the event subscription. It stops receiving events immediately.\n\nRequires the `event-subscriptions:write` scope.\n","parameters":[{"name":"organizationId","in":"path","required":true,"description":"The ID of the organization that owns the event subscriptions.","schema":{"type":"integer","minimum":1}},{"name":"subscriptionId","in":"path","required":true,"description":"The ID of the event subscription.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The ID of the deleted subscription.","content":{"application/json":{"schema":{"type":"object","required":["subscription"],"properties":{"subscription":{"type":"string","format":"uuid","description":"The ID of the deleted subscription."}}}}}},"400":{"description":"A parameter or the request body is invalid (`VALIDATION_FAILED` or `INVALID_URL`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"401":{"description":"Authentication failed, the token lacks the required scope, or an organization-bound token was used for another organization (`IM001` or `SC401`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"403":{"description":"The user lacks the Event subscriptions permission this action needs in the organization (`FORBIDDEN`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"404":{"description":"The subscription does not exist in this organization (`SUBSCRIPTION_NOT_FOUND`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"500":{"description":"An unexpected error occurred (`INTERNAL_ERROR`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"503":{"description":"A required service is temporarily unavailable (`SERVICE_UNAVAILABLE`). Retry the request.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}}}}}}}
```

## Update an event subscription

> Updates the fields in the request body and leaves the others unchanged. Send at least one field.\
> \
> To change whether the subscription receives events, use Enable or Disable instead.\
> \
> Requires the \`event-subscriptions:write\` scope.<br>

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Event subscriptions","description":"The following endpoints let you manage event subscriptions, which send Make events, such as a scenario being created, to your HTTPS endpoint, and inspect and resend their deliveries."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["event-subscriptions:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/event-subscriptions/v1/organizations/{organizationId}/subscriptions/{subscriptionId}":{"patch":{"operationId":"updateEventSubscription","tags":["Event subscriptions"],"summary":"Update an event subscription","description":"Updates the fields in the request body and leaves the others unchanged. Send at least one field.\n\nTo change whether the subscription receives events, use Enable or Disable instead.\n\nRequires the `event-subscriptions:write` scope.\n","parameters":[{"name":"organizationId","in":"path","required":true,"description":"The ID of the organization that owns the event subscriptions.","schema":{"type":"integer","minimum":1}},{"name":"subscriptionId","in":"path","required":true,"description":"The ID of the event subscription.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"\\S","description":"The name of the subscription. It must contain at least one non-whitespace character."},"url":{"type":"string","minLength":1,"description":"The HTTPS endpoint that receives the events. It must be publicly reachable and must not contain a username or password."},"events":{"description":"Which event types the subscription receives. `all` also includes event types added later.","oneOf":[{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"type":"string","enum":["all"]}}},{"type":"object","additionalProperties":false,"required":["mode","types"],"properties":{"mode":{"type":"string","enum":["selected"]},"types":{"type":"array","minItems":1,"maxItems":100,"uniqueItems":true,"description":"Event types returned by List event types.","items":{"type":"string","minLength":1}}}}]},"teams":{"description":"Which teams' events the subscription receives. Applies only to event types with `supportsTeamSelection`. Defaults to all teams.","oneOf":[{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"type":"string","enum":["all"]}}},{"type":"object","additionalProperties":false,"required":["mode","ids"],"properties":{"mode":{"type":"string","enum":["selected"]},"ids":{"type":"array","minItems":1,"maxItems":1000,"uniqueItems":true,"items":{"type":"integer","minimum":1,"maximum":2147483647}}}}]}}}}}},"responses":{"200":{"description":"The updated event subscription.","content":{"application/json":{"schema":{"type":"object","required":["subscription"],"properties":{"subscription":{"type":"object","required":["id","organizationId","name","url","status","events","teams","createdAt","updatedAt"],"properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"integer"},"name":{"type":"string"},"url":{"type":"string"},"status":{"type":"object","required":["state","reason"],"properties":{"state":{"type":"string","enum":["active","inactive","suspended"],"description":"`active` receives events, `inactive` was disabled, and `suspended` stopped sending after repeated failed deliveries until it is enabled again."},"reason":{"type":"string","nullable":true,"description":"Why the subscription is `suspended`, and `null` for other states. New reasons may be added, so accept unknown values."}}},"events":{"type":"object","required":["mode","payloadVersions"],"properties":{"mode":{"type":"string","enum":["all","selected"]},"types":{"type":"array","description":"Present when `mode` is `selected`.","items":{"type":"string"}},"payloadVersions":{"type":"object","description":"The payload version this subscription receives for each subscribed event type. Read-only.","additionalProperties":{"type":"integer","minimum":1}}}},"teams":{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["all","selected"]},"ids":{"type":"array","description":"Present when `mode` is `selected`.","items":{"type":"integer"}}}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}}}}}}},"400":{"description":"A parameter or the request body is invalid (`VALIDATION_FAILED` or `INVALID_URL`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"401":{"description":"Authentication failed, the token lacks the required scope, or an organization-bound token was used for another organization (`IM001` or `SC401`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"403":{"description":"The user lacks the Event subscriptions permission this action needs in the organization (`FORBIDDEN`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"404":{"description":"The subscription does not exist in this organization (`SUBSCRIPTION_NOT_FOUND`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"409":{"description":"The subscription can no longer deliver events and must be recreated (`SUBSCRIPTION_RECREATION_REQUIRED`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"500":{"description":"An unexpected error occurred (`INTERNAL_ERROR`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"503":{"description":"A required service is temporarily unavailable (`SERVICE_UNAVAILABLE`). Retry the request.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}}}}}}}
```

## Enable an event subscription

> Starts sending events to the subscription again, including one that is \`suspended\` after repeated failed deliveries. Enabling an active subscription has no effect.\
> \
> Requires the \`event-subscriptions:write\` scope.<br>

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Event subscriptions","description":"The following endpoints let you manage event subscriptions, which send Make events, such as a scenario being created, to your HTTPS endpoint, and inspect and resend their deliveries."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["event-subscriptions:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/event-subscriptions/v1/organizations/{organizationId}/subscriptions/{subscriptionId}/enable":{"post":{"operationId":"enableEventSubscription","tags":["Event subscriptions"],"summary":"Enable an event subscription","description":"Starts sending events to the subscription again, including one that is `suspended` after repeated failed deliveries. Enabling an active subscription has no effect.\n\nRequires the `event-subscriptions:write` scope.\n","parameters":[{"name":"organizationId","in":"path","required":true,"description":"The ID of the organization that owns the event subscriptions.","schema":{"type":"integer","minimum":1}},{"name":"subscriptionId","in":"path","required":true,"description":"The ID of the event subscription.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The enabled event subscription.","content":{"application/json":{"schema":{"type":"object","required":["subscription"],"properties":{"subscription":{"type":"object","required":["id","organizationId","name","url","status","events","teams","createdAt","updatedAt"],"properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"integer"},"name":{"type":"string"},"url":{"type":"string"},"status":{"type":"object","required":["state","reason"],"properties":{"state":{"type":"string","enum":["active","inactive","suspended"],"description":"`active` receives events, `inactive` was disabled, and `suspended` stopped sending after repeated failed deliveries until it is enabled again."},"reason":{"type":"string","nullable":true,"description":"Why the subscription is `suspended`, and `null` for other states. New reasons may be added, so accept unknown values."}}},"events":{"type":"object","required":["mode","payloadVersions"],"properties":{"mode":{"type":"string","enum":["all","selected"]},"types":{"type":"array","description":"Present when `mode` is `selected`.","items":{"type":"string"}},"payloadVersions":{"type":"object","description":"The payload version this subscription receives for each subscribed event type. Read-only.","additionalProperties":{"type":"integer","minimum":1}}}},"teams":{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["all","selected"]},"ids":{"type":"array","description":"Present when `mode` is `selected`.","items":{"type":"integer"}}}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}}}}}}},"400":{"description":"A parameter or the request body is invalid (`VALIDATION_FAILED` or `INVALID_URL`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"401":{"description":"Authentication failed, the token lacks the required scope, or an organization-bound token was used for another organization (`IM001` or `SC401`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"403":{"description":"The user lacks the Event subscriptions permission this action needs in the organization (`FORBIDDEN`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"404":{"description":"The subscription does not exist in this organization (`SUBSCRIPTION_NOT_FOUND`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"409":{"description":"The subscription can no longer deliver events and must be recreated (`SUBSCRIPTION_RECREATION_REQUIRED`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"500":{"description":"An unexpected error occurred (`INTERNAL_ERROR`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"503":{"description":"A required service is temporarily unavailable (`SERVICE_UNAVAILABLE`). Retry the request.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}}}}}}}
```

## Disable an event subscription

> Stops sending events to the subscription until it is enabled again. Events that occur meanwhile are not delivered later. Disabling an inactive subscription has no effect.\
> \
> Requires the \`event-subscriptions:write\` scope.<br>

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Event subscriptions","description":"The following endpoints let you manage event subscriptions, which send Make events, such as a scenario being created, to your HTTPS endpoint, and inspect and resend their deliveries."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["event-subscriptions:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/event-subscriptions/v1/organizations/{organizationId}/subscriptions/{subscriptionId}/disable":{"post":{"operationId":"disableEventSubscription","tags":["Event subscriptions"],"summary":"Disable an event subscription","description":"Stops sending events to the subscription until it is enabled again. Events that occur meanwhile are not delivered later. Disabling an inactive subscription has no effect.\n\nRequires the `event-subscriptions:write` scope.\n","parameters":[{"name":"organizationId","in":"path","required":true,"description":"The ID of the organization that owns the event subscriptions.","schema":{"type":"integer","minimum":1}},{"name":"subscriptionId","in":"path","required":true,"description":"The ID of the event subscription.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The disabled event subscription.","content":{"application/json":{"schema":{"type":"object","required":["subscription"],"properties":{"subscription":{"type":"object","required":["id","organizationId","name","url","status","events","teams","createdAt","updatedAt"],"properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"integer"},"name":{"type":"string"},"url":{"type":"string"},"status":{"type":"object","required":["state","reason"],"properties":{"state":{"type":"string","enum":["active","inactive","suspended"],"description":"`active` receives events, `inactive` was disabled, and `suspended` stopped sending after repeated failed deliveries until it is enabled again."},"reason":{"type":"string","nullable":true,"description":"Why the subscription is `suspended`, and `null` for other states. New reasons may be added, so accept unknown values."}}},"events":{"type":"object","required":["mode","payloadVersions"],"properties":{"mode":{"type":"string","enum":["all","selected"]},"types":{"type":"array","description":"Present when `mode` is `selected`.","items":{"type":"string"}},"payloadVersions":{"type":"object","description":"The payload version this subscription receives for each subscribed event type. Read-only.","additionalProperties":{"type":"integer","minimum":1}}}},"teams":{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["all","selected"]},"ids":{"type":"array","description":"Present when `mode` is `selected`.","items":{"type":"integer"}}}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}}}}}}},"400":{"description":"A parameter or the request body is invalid (`VALIDATION_FAILED` or `INVALID_URL`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"401":{"description":"Authentication failed, the token lacks the required scope, or an organization-bound token was used for another organization (`IM001` or `SC401`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"403":{"description":"The user lacks the Event subscriptions permission this action needs in the organization (`FORBIDDEN`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"404":{"description":"The subscription does not exist in this organization (`SUBSCRIPTION_NOT_FOUND`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"409":{"description":"The subscription can no longer deliver events and must be recreated (`SUBSCRIPTION_RECREATION_REQUIRED`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"500":{"description":"An unexpected error occurred (`INTERNAL_ERROR`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"503":{"description":"A required service is temporarily unavailable (`SERVICE_UNAVAILABLE`). Retry the request.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}}}}}}}
```

## List deliveries

> Lists the deliveries of an event subscription, newest first by default.\
> \
> To get the next page, set \`pg\[last]\` to the \`id\` of the last delivery on the current page. Use \`pg.last\` from the response instead when \`truncated\` is true.\
> \
> Filter with \`eventType\`, \`teamId\`, \`status\` and \`httpStatus\`. Repeat a parameter to match several values. A delivery is returned if it matches any value of each filter you send, and all of the filters. When you filter by \`status\` or \`httpStatus\`, a page can be short or empty while \`truncated\` is \`true\`.\
> \
> Requires the \`event-subscriptions:read\` scope.<br>

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Event subscriptions","description":"The following endpoints let you manage event subscriptions, which send Make events, such as a scenario being created, to your HTTPS endpoint, and inspect and resend their deliveries."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["event-subscriptions:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/event-subscriptions/v1/organizations/{organizationId}/subscriptions/{subscriptionId}/deliveries":{"get":{"operationId":"listEventSubscriptionDeliveries","tags":["Event subscriptions"],"summary":"List deliveries","description":"Lists the deliveries of an event subscription, newest first by default.\n\nTo get the next page, set `pg[last]` to the `id` of the last delivery on the current page. Use `pg.last` from the response instead when `truncated` is true.\n\nFilter with `eventType`, `teamId`, `status` and `httpStatus`. Repeat a parameter to match several values. A delivery is returned if it matches any value of each filter you send, and all of the filters. When you filter by `status` or `httpStatus`, a page can be short or empty while `truncated` is `true`.\n\nRequires the `event-subscriptions:read` scope.\n","parameters":[{"name":"organizationId","in":"path","required":true,"description":"The ID of the organization that owns the event subscriptions.","schema":{"type":"integer","minimum":1}},{"name":"subscriptionId","in":"path","required":true,"description":"The ID of the event subscription.","schema":{"type":"string","format":"uuid"}},{"name":"pg[limit]","in":"query","description":"The maximum number of deliveries to return.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"pg[sortDir]","in":"query","description":"The sort direction.","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"pg[last]","in":"query","description":"The ID of the last delivery on the previous page. The response starts after it. Must be a delivery of this subscription. When the previous response had `truncated` set to true, send its `pg.last` here, even if the page was short or empty.","schema":{"type":"string","format":"uuid"}},{"name":"pg[showLast]","in":"query","description":"If `true`, the response also includes the delivery set in `pg[last]`.","schema":{"type":"boolean","default":false}},{"name":"eventType","in":"query","description":"Return only deliveries of these event types. Repeat the parameter to match several (`eventType=scenario.created&eventType=scenario.updated`).","schema":{"type":"array","maxItems":100,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":200}}},{"name":"teamId","in":"query","description":"Return only deliveries for these team IDs. Repeat the parameter to match several (`teamId=12&teamId=34`). Organization-level deliveries (`teamId: null`) never match.","schema":{"type":"array","maxItems":100,"uniqueItems":true,"items":{"type":"integer","minimum":1}}},{"name":"status","in":"query","description":"Return only deliveries whose `status.state` is one of these values. Repeat the parameter to match several (`status=failed&status=pending`). A delivery whose latest attempt failed counts as `failed`, even while it is queued for retry. A filtered page can be short or empty while `truncated` is `true`; see `truncated`.","schema":{"type":"array","maxItems":3,"uniqueItems":true,"items":{"type":"string","enum":["pending","succeeded","failed"]}}},{"name":"httpStatus","in":"query","description":"Return only deliveries whose `status.httpStatus` is one of these codes: the HTTP status your endpoint returned on the latest attempt. Deliveries where your endpoint never responded (`httpStatus: null`) never match. Repeat the parameter to match several (`httpStatus=500&httpStatus=502`). A filtered page can be short or empty while `truncated` is `true`; see `truncated`.","schema":{"type":"array","maxItems":20,"uniqueItems":true,"items":{"type":"integer","minimum":100,"maximum":599}}},{"name":"createdFrom","in":"query","description":"Return only deliveries created at or after this time (inclusive).","schema":{"type":"string","format":"date-time"}},{"name":"createdTo","in":"query","description":"Return only deliveries created before this time (exclusive).","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"A page of the subscription's deliveries.","content":{"application/json":{"schema":{"type":"object","required":["deliveries","pg","truncated"],"properties":{"deliveries":{"type":"array","items":{"type":"object","required":["id","subscriptionId","eventType","payloadVersion","teamId","status","attemptCount","succeededAt","createdAt"],"properties":{"id":{"type":"string","format":"uuid"},"subscriptionId":{"type":"string","format":"uuid"},"eventType":{"type":"string","nullable":true},"payloadVersion":{"type":"integer","nullable":true},"teamId":{"type":"integer","nullable":true,"description":"The team the event belongs to, and `null` for organization-level events."},"status":{"type":"object","required":["state","reason","httpStatus"],"properties":{"state":{"type":"string","enum":["pending","succeeded","failed"]},"reason":{"type":"string","nullable":true,"enum":["endpoint_error","endpoint_unreachable","subscription_suspended","platform_error"],"description":"Why the delivery `failed`, and `null` otherwise."},"httpStatus":{"type":"integer","nullable":true,"description":"The HTTP status of the latest attempt, if the endpoint answered."}}},"attemptCount":{"type":"integer"},"succeededAt":{"type":"string","format":"date-time","nullable":true},"createdAt":{"type":"string","format":"date-time"}}}},"truncated":{"type":"boolean","description":"`true` when the response stopped before the page was full. This only happens when you filter by `status` or `httpStatus`: each request examines a limited number of deliveries, so the page can be short or even empty, and that doesn't mean the list has ended. To continue, repeat the request with the same filters, `pg[limit]` and `pg[sortDir]`, set `pg[last]` to this response's `pg.last`, and leave `pg[showLast]` unset or `false`. Stop when `truncated` is `false` and the page holds fewer than `pg[limit]` deliveries."},"pg":{"type":"object","required":["limit","sortDir"],"properties":{"limit":{"type":"integer"},"sortDir":{"type":"string","enum":["asc","desc"]},"last":{"type":"string","format":"uuid","description":"The cursor to continue from. When `truncated` is `true`, this is the last delivery the request examined, which may not be in `deliveries`; send it as `pg[last]` in the next request. Otherwise it repeats the `pg[last]` you sent, and is omitted if you didn't send one."},"showLast":{"type":"boolean"}}}}}}}},"400":{"description":"A parameter or the request body is invalid (`VALIDATION_FAILED` or `INVALID_URL`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"401":{"description":"Authentication failed, the token lacks the required scope, or an organization-bound token was used for another organization (`IM001` or `SC401`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"403":{"description":"The user lacks the Event subscriptions permission this action needs in the organization (`FORBIDDEN`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"404":{"description":"The subscription does not exist in this organization (`SUBSCRIPTION_NOT_FOUND`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"500":{"description":"An unexpected error occurred (`INTERNAL_ERROR`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"503":{"description":"A required service is temporarily unavailable (`SERVICE_UNAVAILABLE`). Retry the request.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}}}}}}}
```

## Get a delivery

> Gets a delivery with the event that was sent and every attempt to send it.\
> \
> Requires the \`event-subscriptions:read\` scope.<br>

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Event subscriptions","description":"The following endpoints let you manage event subscriptions, which send Make events, such as a scenario being created, to your HTTPS endpoint, and inspect and resend their deliveries."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["event-subscriptions:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/event-subscriptions/v1/organizations/{organizationId}/subscriptions/{subscriptionId}/deliveries/{deliveryId}":{"get":{"operationId":"getEventSubscriptionDelivery","tags":["Event subscriptions"],"summary":"Get a delivery","description":"Gets a delivery with the event that was sent and every attempt to send it.\n\nRequires the `event-subscriptions:read` scope.\n","parameters":[{"name":"organizationId","in":"path","required":true,"description":"The ID of the organization that owns the event subscriptions.","schema":{"type":"integer","minimum":1}},{"name":"subscriptionId","in":"path","required":true,"description":"The ID of the event subscription.","schema":{"type":"string","format":"uuid"}},{"name":"deliveryId","in":"path","required":true,"description":"The ID of the delivery.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The delivery with its event and attempts.","content":{"application/json":{"schema":{"type":"object","required":["delivery"],"properties":{"delivery":{"allOf":[{"type":"object","required":["id","subscriptionId","eventType","payloadVersion","teamId","status","attemptCount","succeededAt","createdAt"],"properties":{"id":{"type":"string","format":"uuid"},"subscriptionId":{"type":"string","format":"uuid"},"eventType":{"type":"string","nullable":true},"payloadVersion":{"type":"integer","nullable":true},"teamId":{"type":"integer","nullable":true,"description":"The team the event belongs to, and `null` for organization-level events."},"status":{"type":"object","required":["state","reason","httpStatus"],"properties":{"state":{"type":"string","enum":["pending","succeeded","failed"]},"reason":{"type":"string","nullable":true,"enum":["endpoint_error","endpoint_unreachable","subscription_suspended","platform_error"],"description":"Why the delivery `failed`, and `null` otherwise."},"httpStatus":{"type":"integer","nullable":true,"description":"The HTTP status of the latest attempt, if the endpoint answered."}}},"attemptCount":{"type":"integer"},"succeededAt":{"type":"string","format":"date-time","nullable":true},"createdAt":{"type":"string","format":"date-time"}}},{"type":"object","required":["event","attempts"],"properties":{"event":{"type":"object","description":"The event as it was sent to the endpoint.","required":["type","version","data","timestamp"],"properties":{"type":{"type":"string"},"version":{"type":"integer"},"data":{"type":"object","additionalProperties":true},"timestamp":{"type":"string","format":"date-time"}}},"attempts":{"type":"array","description":"Every attempt, newest first.","items":{"type":"object","required":["attemptNumber","manual","attemptedAt","durationMs","status","responseBody","responseBodyTruncated"],"properties":{"attemptNumber":{"type":"integer"},"manual":{"type":"boolean","description":"`true` for an attempt started by Resend a delivery."},"attemptedAt":{"type":"string","format":"date-time"},"durationMs":{"type":"integer","nullable":true},"status":{"type":"object","required":["state","reason","httpStatus"],"properties":{"state":{"type":"string","enum":["succeeded","failed"]},"reason":{"type":"string","nullable":true,"enum":["endpoint_error","endpoint_unreachable"]},"httpStatus":{"type":"integer","nullable":true}}},"responseBody":{"type":"string","nullable":true,"description":"The endpoint's response, cut off at 4 KiB. It comes from the endpoint, so treat it as untrusted."},"responseBodyTruncated":{"type":"boolean"}}}}}}]}}}}}},"400":{"description":"A parameter or the request body is invalid (`VALIDATION_FAILED` or `INVALID_URL`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"401":{"description":"Authentication failed, the token lacks the required scope, or an organization-bound token was used for another organization (`IM001` or `SC401`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"403":{"description":"The user lacks the Event subscriptions permission this action needs in the organization (`FORBIDDEN`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"404":{"description":"The subscription or the delivery does not exist (`SUBSCRIPTION_NOT_FOUND` or `DELIVERY_NOT_FOUND`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"500":{"description":"An unexpected error occurred (`INTERNAL_ERROR`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"503":{"description":"A required service is temporarily unavailable (`SERVICE_UNAVAILABLE`). Retry the request.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}}}}}}}
```

## Resend a delivery

> Sends the delivery's event to the endpoint again as a new, manual attempt. The response confirms that the resend was accepted, not that it succeeded. Get the delivery to see the outcome.\
> \
> Requires the \`event-subscriptions:write\` scope.<br>

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Event subscriptions","description":"The following endpoints let you manage event subscriptions, which send Make events, such as a scenario being created, to your HTTPS endpoint, and inspect and resend their deliveries."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["event-subscriptions:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/event-subscriptions/v1/organizations/{organizationId}/subscriptions/{subscriptionId}/deliveries/{deliveryId}/resend":{"post":{"operationId":"resendEventSubscriptionDelivery","tags":["Event subscriptions"],"summary":"Resend a delivery","description":"Sends the delivery's event to the endpoint again as a new, manual attempt. The response confirms that the resend was accepted, not that it succeeded. Get the delivery to see the outcome.\n\nRequires the `event-subscriptions:write` scope.\n","parameters":[{"name":"organizationId","in":"path","required":true,"description":"The ID of the organization that owns the event subscriptions.","schema":{"type":"integer","minimum":1}},{"name":"subscriptionId","in":"path","required":true,"description":"The ID of the event subscription.","schema":{"type":"string","format":"uuid"}},{"name":"deliveryId","in":"path","required":true,"description":"The ID of the delivery.","schema":{"type":"string","format":"uuid"}}],"responses":{"202":{"description":"The resend was accepted.","content":{"application/json":{"schema":{"type":"object","required":["resend"],"properties":{"resend":{"type":"object","required":["deliveryId","subscriptionId"],"properties":{"deliveryId":{"type":"string","format":"uuid"},"subscriptionId":{"type":"string","format":"uuid"}}}}}}}},"400":{"description":"A parameter or the request body is invalid (`VALIDATION_FAILED` or `INVALID_URL`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"401":{"description":"Authentication failed, the token lacks the required scope, or an organization-bound token was used for another organization (`IM001` or `SC401`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"403":{"description":"The user lacks the Event subscriptions permission this action needs in the organization (`FORBIDDEN`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"404":{"description":"The subscription or the delivery does not exist (`SUBSCRIPTION_NOT_FOUND` or `DELIVERY_NOT_FOUND`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"409":{"description":"The delivery can't be resent (`DELIVERY_NOT_RETRYABLE`, `SUBSCRIPTION_INACTIVE` or `SUBSCRIPTION_SUSPENDED`): it hasn't been attempted yet, it is too old to resend, or the subscription isn't active. Enable the subscription before resending.\n","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"500":{"description":"An unexpected error occurred (`INTERNAL_ERROR`).","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}},"503":{"description":"A required service is temporarily unavailable (`SERVICE_UNAVAILABLE`). Retry the request.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable error code, for example `SUBSCRIPTION_NOT_FOUND`."},"message":{"type":"string"},"detail":{"type":"string","description":"What went wrong and, where possible, how to fix it."}}}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.make.com/api-documentation/api-reference/event-subscriptions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.