TRtruv
Webhooks

Create a webhook endpoint

Changed on

The endpoint creates a webhook.

post/v1/webhooks/

Request

  • Base URL
    https://prod.truv.com
  • URL
    https://prod.truv.com/v1/webhooks/
  • Auth
    API key in header X-Access-Client-Id and API key in header X-Access-Secret

Request body

namestring required

Public name for this webhook config.

webhook_urlstring uri required

Webhook URL where event data will be sent.

eventsstring[]

List of events sent to this webhook URL.

env_type'sandbox' | 'dev' | 'prod' required

Type of environment.

enabledboolean

Whether the webhook is active.

Example request

{
  "webhook_url": "http://example.com/",
  "events": [
    "task-status-updated",
    "order-status-updated"
  ],
  "env_type": "dev"
}

Response

idstring required

Unique identifier of the webhook.

namestring required

Public name for this webhook config.

webhook_urlstring uri required

Webhook URL where event data will be sent.

eventsstring[] required

List of events sent to this webhook URL.

env_type'sandbox' | 'dev' | 'prod' required

Type of environment.

enabledboolean required

Whether the webhook is active.

created_atstring date-time required

Timestamp when the webhook was created.

updated_atstring date-time required

Timestamp when the webhook was updated last time.

Example response

{
  "id": "48427a36d43c4d5aa6324bc06c692456",
  "webhook_url": "http://example.com/",
  "events": [
    "task-status-updated",
    "order-status-updated"
  ],
  "env_type": "dev",
  "created_at": "2022-05-04T11:30:00Z",
  "updated_at": "2022-05-04T12:00:00Z"
}

Changes

  • 16345eb80970Revision changes
    • warning

      added the new order-batch-completed enum value to the / response property for the response status

    • info

      added the new order-batch-completed enum value to the request property /

  • e58688835e25Revision changes
    • warning

      added the new certification-completed enum value to the / response property for the response status

    • warning

      added the new order-finalized enum value to the / response property for the response status

    • info

      added the new certification-completed enum value to the request property /

    • info

      added the new order-finalized enum value to the request property /