Create a webhook

AuthorizationBasic

Basic authentication of the form Basic <username:password>.

This endpoint expects an object.

urlstringRequired

Webhook endpoint URL

enabled_eventslist of stringsRequired

Array of event types to subscribe to, or [”*”] for all events

secretstringOptional

Secret for webhook signature verification

oidc_client_idstringOptional

OIDC client ID

oidc_token_endpointstringOptional

OIDC token endpoint URL

oidc_resource_uristringOptional

OIDC resource URI

oidc_access_token_ttl_secondsintegerOptional

OIDC access token TTL in seconds

webhook created with wildcard events

1	curl -X POST https://api.middesk.com/v1/webhooks \
2	-H "Content-Type: application/json" \
3	-u "<username>:<password>" \
4	-d '{
5	"url": "https://example.com/webhooks/middesk",
6	"enabled_events": [
7	"business.created",
8	"business.updated",
9	"order.completed"
10	],
11	"secret": "whsec_abcdef123456"
12	}'

1	{
2	"object": "webhook",
3	"id": "f2a3b4c5-d6e7-8901-5678-9abcdef01234",
4	"url": "https://example.com/webhooks/middesk",
5	"enabled_events": [
6	"business.created",
7	"business.updated",
8	"order.completed"
9	],
10	"created_at": "2025-01-07T12:00:00.000Z",
11	"updated_at": "2025-01-07T12:00:00.000Z"
12	}