POST
/
webhooks
/
configurations
curl --request POST \
  --url https://api-sandbox.orum.io/webhooks/configurations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Orum-Version: <orum-version>' \
  --data '{
  "event_types": [
    "subscribe_all"
  ],
  "url": "<string>",
  "enabled": true
}'
{
  "webhook_configuration": {
    "id": "<string>",
    "enterprise_name": "<string>",
    "data_version": "v2022-09-21",
    "event_types": [
      "subscribe_all"
    ],
    "enabled": true,
    "url": "<string>",
    "created_at": "<string>",
    "created_by": "<string>",
    "updated_at": "<string>",
    "updated_by": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Orum-Version
enum<string>
required

Version of Deliver API. Use v2022-09-21.

Available options:
v2022-09-21

Body

application/json
​
event_types
enum<string>[]
required

The types of events for which you would like to receive a webhook e.g. transfer_created. Use subscribe_all to receive webhooks for all events.

The type of event you want to invoke a webhook for.

Available options:
subscribe_all,
person_created,
person_verified,
person_rejected,
person_restricted,
person_unverified,
person_closed,
person_all,
business_created,
business_verified,
business_rejected,
business_restricted,
business_unverified,
business_closed,
business_all,
external_account_created,
external_account_verified,
external_account_rejected,
external_account_restricted,
external_account_unverified,
external_account_closed,
external_account_all,
transfer_updated,
transfer_all,
verify_account_updated,
subledger_all,
subledger_created
​
url
string
required

The URL where you would like the webhook to be sent.

​
enabled
boolean
required

A boolean to determine whether the configuration is enabled. Acts as an on/off switch for that particular webhook.

Response

200 - application/json
200 response.
​
webhook_configuration
object
required

Was this page helpful?

Event Types and PayloadsRetrieve List Of Webhook Configurations