14. Webhooks

Update subscription

patch/webhooks/{webhookId}

Request

Base URL
https://integration-api.tangocard.com/raas/v2
URL
https://integration-api.tangocard.com/raas/v2/webhooks/{webhookId}
Auth
- HTTP basic
- or HTTP bearer

Path parameters

webhookIdstring uuid required

The webhook identifier

Request body

urlstring

The URL of the customer's webhook listener. Must be a valid URL.

categoriesstring[]

The categories the customer wants to subscribe to.

eventTypesstring[]

The event types the customer wants to subscribe to.

signingCertificatestring

The public X509 certificate used to sign the webhook payload. The certificate must be base64 encoded.

hmacSharedSecretKeystring

The HMAC secret key used to sign the webhook payload. Required when payloadVerificationMethod is HMAC. The key must be base64 encoded.

payloadVerificationMethod'HMAC' | 'X509' | 'NONE'

Method to verify webhook payload integrity

Response

webhookIdstring uuid

The ID of the webhook.

urlstring

The URL of the customer's webhook listener.

categoriesstring[]

The categories the customer is subscribed to.

eventTypesstring[]

The event types the customer is subscribed to.

signingCertificatestring

The public X509 certificate used to sign the webhook payload. The certificate is base64 encoded.

createdAtstring date-time

The date and time the webhook was created.

expiresAtstring date-time

The date and time the webhook expires.

updatedAtstring date-time

The date and time when the webhook was last updated.