webhooks

Update webhook

Update a webhook subscription (name, endpoint, and/or event types).

patch/v1/webhooks/{id}

Request

Base URL: https://api.botdog.co
URL: https://api.botdog.co/v1/webhooks/{id}
Auth: API key in header x-api-key

Path parameters

idstring required

Request body

namestring

A human-readable name for the webhook

endpointstring

The URL that receives notifications

eventTypesstring[]

Replace the subscribed event types

Response

idstring required

The unique identifier of the webhook

namestring required

A human-readable name for the webhook

endpointstring required

The URL that receives event notifications

statusstring required

The webhook status

scopestring required

Delivery scope. ALL and SPECIFIC_CAMPAIGNS carry campaign events; CONNECTED_ACCOUNT carries events that belong to no campaign, such as inbox messages from outside your campaigns.

typestring required

The webhook type

isTeamWebhookboolean required

Whether the webhook is shared across the team

eventTypesstring[] required

Event types this webhook is subscribed to

campaignIdsstring[] required

Campaign IDs this webhook is scoped to (empty when scope is ALL)

createdAtstring date-time required

When the webhook was created

updatedAtstring date-time required

When the webhook was last updated

Example response

{
  "endpoint": "https://example.com/hooks/botdog",
  "status": "ACTIVE",
  "scope": "ALL",
  "type": "GENERIC",
  "eventTypes": [
    "LEAD_INVITATION_ACCEPTED",
    "LEAD_MESSAGE_REPLIED"
  ]
}

Changes

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