Webhooks

Add webhook topic

Add a topic to a webhook. This api only adds, does not replace topics or updates existing topics. Will throw if a topic type exists for this webhook already.

post/webhooks/{id}/topics

Request

  • Base URL
    https://api.pax8.com/api/v2
  • URL
    https://api.pax8.com/api/v2/webhooks/{id}/topics
  • Auth
    none declared

Path parameters

idstring uuid required

Request body

topicstring required

The topic name to subscribe to

Response

The request has succeeded.

idstring uuid required

Unique identifier for the webhook

accountIdstring uuid required

Account ID that owns this webhook

displayNamestring required

Display name for the webhook

urlstring

URL where webhook events will be sent

authorizationstring

Authorization header value for webhook

activeboolean required

Whether the webhook is active

contactEmailstring

Email address to notify when webhook delivery errors occur

errorThresholdinteger required

Number of times a webhook will be retried and consecutive errors will result in an email notification

integrationIdstring uuid

Id of the integration this webhook is associated with, if applicable

lastDeliveryStatus'PENDING' | 'SUCCESS' | 'FAILED' | 'RETRYING'

Status of webhook delivery

createdAtstring date-time required

Timestamp when the webhook was created

updatedAtstring date-time required

Timestamp when the webhook was last updated

Changes

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