PATCH/v1/webhook-endpoints/{id}

updateWebhookEndpoint

Update a webhook endpoint. Updates the URL (re-validated through the SSRF gauntlet), the event-type subscription list, and/or `enabled`. Setting `enabled: true` on an auto-disabled endpoint clears its failure ladder and resumes deliveries.

Required scope:webhooks:write

Parameters

idpath · stringrequired

Webhook endpoint id.

Request body

Partial update — at least one field is required.

urlstringoptional

Replacement delivery URL — re-validated through the same SSRF gauntlet as creation.

event_typesarray of "post.published" | "post.failed" | "channel.connected" | "channel.reauth_required" | "delivery.failed"optional

Replacement event-type subscription list.

enabledbooleanoptional

Enable or disable deliveries. Setting `true` on an auto-disabled endpoint clears its failure state and resumes deliveries.

Depth-limited view — the interactive reference has every nested schema.

Responses

200WebhookEndpoint

The updated endpoint.

400invalid_request validation_failed

401authentication_required invalid_api_key

403insufficient_scope feature_not_enabled

404resource_not_found

409resource_conflict

429rate_limited quota_exhausted

500internal_error

Errors are RFC 9457 problem+json with a stable code and a request_id — each code above links to its own page.

Example

PATCH /v1/webhook-endpoints/{id}

curl -X PATCH https://app.usepostify.com/v1/webhook-endpoints/post_9x2y3z0001 \
  -H "Authorization: Bearer postify_live_XXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
  "enabled": true
}'