Skip to main content
PATCH
/
v3
/
webhook
/
destinations
/
{destination_uuid}
Update Webhook Destination
curl --request PATCH \
  --url https://verification.didit.me/v3/webhook/destinations/{destination_uuid}/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "label": "<string>",
  "url": "<string>",
  "enabled": true,
  "webhook_version": "v1",
  "subscribed_events": [
    "status.updated",
    "data.updated"
  ]
}
'
{}

Documentation Index

Fetch the complete documentation index at: https://docs.didit.me/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint to change where a destination sends webhooks and which events it receives.

​
Updating subscribed_events

When you send subscribed_events, provide the complete event list that should remain subscribed after the update. The array replaces the previous subscription set. 
{
  "subscribed_events": [
    "status.updated",
    "data.updated",
    "transaction.created",
    "transaction.status.updated"
  ]
}
Supported values are:
EventWhat it represents
status.updatedUser Verification (KYC) or Business Verification (KYB) session status changed.
data.updatedSession verification data changed after creation.
user.status.updatedUser entity status changed.
user.data.updatedUser entity data changed.
business.status.updatedBusiness entity status changed.
business.data.updatedBusiness entity data changed.
activity.createdActivity timeline entry created.
transaction.createdTransaction created and initially evaluated.
transaction.status.updatedTransaction status changed.
Use the create destination guide for detailed event descriptions and common subscription sets.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
destination_uuid
string<uuid>
required

Body

application/json
​
label
string
​
url
string<uri>
​
enabled
boolean
​
webhook_version
enum<string>
Available options:
v1,
v2,
v3
​
subscribed_events
enum<string>[]

Event filter for this webhook destination. Didit delivers only webhooks whose webhook_type exactly matches one of these values. Include at least one event; there is no wildcard subscription.

Minimum array length: 1

Supported webhook event name. Use these exact strings in subscribed_events; unsupported values are rejected.

Available options:
status.updated,
data.updated,
user.status.updated,
user.data.updated,
business.status.updated,
business.data.updated,
activity.created,
transaction.created,
transaction.status.updated
Example:
["status.updated", "data.updated"]

Response

200 - application/json

Updated webhook destination.

The response is of type object.