Update Webhook

PUT /webhooks/:webhookId

Updates the definition of an existing webhook.

Permissions Required

  • Webhooks:Update

Request Body

{
  "url": "https://example.com/my/new/webhook/endpoint", // optional
  "description": "My updated webhook", // optional
  "status": "Enabled" // optional
  "events": [ // optional                             
    "wallet.transfer.initiated",
    "wallet.transfer.executed",
    "wallet.transfer.confirmed",
  ],

}
PropertyType - OptionalDescription

url

String - Optional

The webhook endpoint url where events will be pushed. The url needs to be a valid http / https url.

description

String - Optional

Description of what the endpoint is for.

status

String - Optional

Possible values: Enabled | Disabled. If webhook status is Disabled, no event will be pushed to the webhook endpoint. If status is not specified, default status is Enabled.

events

String List - Required

List of supported events the webhook subscribes to. You can also subscribe to all events by passing events: ["*"].

Response

{
  "id": "wh-xxx-xxxxxxx",
  "url": "https://example.com/my/new/webhook/endpoint",
  "events": [
    "wallet.transfer.initiated",
    "wallet.transfer.executed",
    "wallet.transfer.confirmed",
  ],
  "description": "My updated webhook",
  "status": "Enabled",
  "dateCreated": "2023-11-01T08:52:01.186Z",
  "dateUpdated": "2023-12-01T08:52:01.186Z",
}

PropertyTypeDescription

id

String

ID of the webhook

url

String

See above

description

String

See above

status

String

See above

events

String List

See above

dateCreated

String

ISO 8601 string representing date of creation of the webhook

dateUpdated

String

ISO 8601 string representing date of update of the webhook

Last updated