API referenceWebhookEndpoint
Creates a WebhookEndpoint resource.
Creates a WebhookEndpoint resource.
POST
/api/webhook_endpointscurl -X POST "/api/webhook_endpoints" \
-H "apikey: $MEDIALISTER_CLIENT_API_KEY" \
-H "Content-Type: application/ld+json" \
-d '{
"url": "https://example.com"
}'Authorization
apikeystringheaderrequiredValue for the apikey header parameter.
Body
application/ld+json
The new WebhookEndpoint resource
audienceenum<string>Which side of the organization receives the events:
publisher(orders of its media) orclient(orders it placed).One of:publisherclientDefault:publisherurlstring<uri>requiredenabledbooleanDefault:true
Response
application/ld+json
WebhookEndpoint resource created
@contextone of@idstringrequired@typestringrequiredidstring<uuid> | nullaudienceenum<string>Which side of the organization receives the events:
publisher(orders of its media) orclient(orders it placed).One of:publisherclientDefault:publisherurlstring<uri>requiredenabledbooleanDefault:trueverifiedAtstring<date-time> | nullWhen the URL last answered a ping with
pong.statusenum<string>active: the last ping or event went through;failing: the last ping failed or an event failed after every retry;disabled: turned off.One of:activefailingdisabledDefault:activelastDeliveredAtstring<date-time> | nulllastFailedAtstring<date-time> | nulllastErrorstring | nullWhy the last ping or event failed; empty after the next success.
createdAtstring<date-time> | nullsecretstring | nullThe signing secret; returned on creation and rotation only, never again.
{
"@context": "string",
"@id": "string",
"@type": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"audience": "publisher",
"url": "https://example.com",
"enabled": true,
"verifiedAt": "2026-01-15T09:30:00Z",
"status": "active",
"lastDeliveredAt": "2026-01-15T09:30:00Z",
"lastFailedAt": "2026-01-15T09:30:00Z",
"lastError": "string",
"createdAt": "2026-01-15T09:30:00Z",
"secret": "string"
}