Skip to main content
PATCH
/
webhooks
/
endpoints
/
{id}
Update a webhook endpoint
curl --request PATCH \
  --url https://api.conduit.financial/v2/webhooks/endpoints/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "url": "https://api.example.com/webhooks/conduit",
  "description": "Production webhook receiver",
  "active": true,
  "subscription": {
    "mode": "SELECTED"
  }
}
'
{
  "id": "<string>",
  "url": "https://api.example.com/webhooks/conduit",
  "description": "Production webhook receiver",
  "active": true,
  "subscription": {
    "mode": "ALL"
  },
  "createdAt": "2026-01-15T09:30:00.000Z",
  "updatedAt": "2026-01-15T09:30:00.000Z"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
id
string
required

Body

application/json
​
url
string<uri>

URL where webhook payloads will be delivered. Must be HTTPS; a URL that resolves to a private or reserved address is rejected.

Maximum string length: 2048
Example:

"https://api.example.com/webhooks/conduit"

​
description
string

Human-readable description of this endpoint's purpose

Maximum string length: 255
Example:

"Production webhook receiver"

​
active
boolean

Set to false to pause deliveries without deleting the endpoint

Example:

true

​
subscription
object

Event subscription configuration

Example:
{ "mode": "SELECTED" }

Response

​
id
string
required

Unique webhook endpoint identifier

Pattern: ^wep_[0-9A-Za-z]{22}$
​
url
string
required

URL where webhook payloads are delivered

Example:

"https://api.example.com/webhooks/conduit"

​
description
string | null
required

Human-readable description of this endpoint's purpose

Example:

"Production webhook receiver"

​
active
boolean
required

Whether this endpoint is currently receiving new deliveries. When false, the endpoint is excluded from event fan-out — no new deliveries are enqueued. In-flight (already-enqueued) deliveries are not cancelled and continue retrying per the normal schedule. Flip back to true via PATCH to resume receiving new deliveries.

Example:

true

​
subscription
object
required

Event subscription configuration for this endpoint

​
createdAt
string<date-time>
required

ISO 8601 timestamp

Example:

"2026-01-15T09:30:00.000Z"

​
updatedAt
string<date-time>
required

ISO 8601 timestamp

Example:

"2026-01-15T09:30:00.000Z"