v2

latestOpenAPI 3.1.02026-07-312303692.4 MB

Webhooks AutoConfig

Update Subscription

Update an auto-config endpoint by providing endpoint details.

put/api/v1/app/{app_id}/endpoint/{endpoint_id}/auto-config

Path parameters

app_idstring required

The Application's ID or UID.

Example:unique-identifier

The Application's ID or UID.

endpoint_idstring required

The Endpoint's ID or UID.

Example:unique-identifier

The Endpoint's ID or UID.

Request body

Example request

{
  "endpoint": {
    "url": "https://example.com/webhook/",
    "description": "An example endpoint name",
    "uid": "unique-identifier",
    "version": 1,
    "filterTypes": [
      "user.signup",
      "user.deleted"
    ],
    "channels": [
      "project_123",
      "group_2"
    ],
    "secret": "whsec_C2FVsBQIhrscChlQIMV+b5sSYspob7oD",
    "headers": {
      "X-Example": "123",
      "X-Foobar": "Bar"
    }
  },
  "sink": {
    "config": {
      "description": "An example endpoint name",
      "uid": "unique-identifier",
      "secret": "whsec_C2FVsBQIhrscChlQIMV+b5sSYspob7oD",
      "filterTypes": [
        "user.signup",
        "user.deleted"
      ],
      "channels": [
        "project_123",
        "group_2"
      ]
    }
  }
}

Response

idstring required

The Endpoint's ID.

metadataobject required

urlstring uri required

descriptionstring required

rateLimitinteger nullable

Deprecated, use throttleRate instead.

throttleRateinteger nullable

Maximum messages per second to send to this endpoint.

Outgoing messages will be throttled to this rate.

uidstring nullable

Optional unique identifier for the endpoint.

versioninteger required

disabledboolean

filterTypesstring[] nullable

channelsstring[] nullable

List of message channels this endpoint listens to (omit for all).

createdAtstring date-time required

updatedAtstring date-time required

Example response

{
  "id": "ep_1srOrx2ZWZBpBUvZwXKQmoEYga2",
  "url": "https://example.com/webhook/",
  "uid": "unique-identifier",
  "version": 1,
  "filterTypes": [
    "user.signup",
    "user.deleted"
  ],
  "channels": [
    "project_123",
    "group_2"
  ]
}