Webhooks

Create webhook subscription

Subscribe to webhook events

post/webhooks

Request

Base URL
https://sandbox.bond.tech/api/v0
Auth
API key in header Identity and API key in header Authorization
TypeScript
https://skmtc.dev/bond/apis/customer/docs/webhooks/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

urlstring required

Webhook callback URL

descriptionstring

Optional description of the webhook's intended use

eventsstring[] required

List of events enabled in the webhook subscription

versionstring

version of webhook event envelope

status'STATUS_ENABLED' | 'STATUS_DISABLED'

status of webhook. enabled or disabled

Example request

{
  "url": "https://hostname.com/webhook/route",
  "description": "KYC state changes.",
  "version": "0.1",
  "status": "STATUS_ENABLED"
}

Response

Example response

{
  "webhook_subscription": {
    "id": "487a7f29-7b80-467d-b20d-7b60c3a14cf0",
    "url": "https://hostname.com/webhook/route",
    "description": "KYC state changes.",
    "version": "0.1",
    "status": "enabled",
    "creted_time": "2022-06-09T18:23:37.585421Z",
    "updated_time": "2022-06-09T18:23:37.585421Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.