v4

OpenAPI 3.1.02026-08-012402353.8 MB

Update an Event Subscription

patch/event_subscriptions/{event_subscription_id}

Path parameters

event_subscription_idstring required

The identifier of the Event Subscription.

Request body

status'active' | 'disabled' | 'deleted'

The status to update the Event Subscription with.

Example request

{}

Response

Event Subscription

created_atstring date-time required

The time the event subscription was created.

idstring required

The event subscription identifier.

idempotency_keystring nullable required

The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about idempotency.

oauth_connection_idstring nullable required

If specified, this subscription will only receive webhooks for Events associated with this OAuth Connection.

status'active' | 'disabled' | 'deleted' required

This indicates if we'll send notifications to this subscription.

type'event_subscription' required

A constant representing the object's type. For this resource it will always be event_subscription.

urlstring required

The webhook url where we'll send notifications.

Example response

{
  "created_at": "2020-01-31T23:59:59Z",
  "id": "event_subscription_001dzz0r20rcdxgb013zqb8m04g",
  "idempotency_key": null,
  "oauth_connection_id": null,
  "selected_event_categories": null,
  "status": "active",
  "type": "event_subscription",
  "url": "https://website.com/webhooks"
}