Update event destination

Modify a webhook destination — change the URL, rotate the signing secret, narrow/widen subscribed event types, or pause delivery.


PATCH /api/v1/partner/email/configuration-sets/:id/event-destinations/:dest_id

All fields optional — pass only what’s changing.

Request body


{
  "webhook_url": "https://yourapp.com/v2/webhooks/email",
  "webhook_secret": "rotated-secret-here",
  "matching_event_types": ["bounce", "complaint"],
  "enabled": true
}

Field	Type	Notes
`name`	string
`webhook_url`	string	HTTP(S) only
`webhook_secret`	string	New value overwrites the old. API never echoes back
`matching_event_types`	string[]	Replaces the existing list
`enabled`	bool	Pause/resume delivery

Rotating the webhook secret

Sequence:

Generate a new secret on your side (openssl rand -hex 32)
Update your endpoint to accept both old and new secrets for ~30 seconds
PATCH this endpoint with the new secret
Wait until in-flight requests drain (~30 seconds)
Remove old-secret support from your endpoint

We don’t echo old-or-new values, so the rotation window has to be coordinated by your code.

cURL


curl -X PATCH \
  https://apis.splashifypro.com/api/v1/partner/email/configuration-sets/cs_.../event-destinations/ed_... \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'