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
json
{
"webhook_url": "https://yourapp.com/v2/webhooks/email",
"webhook_secret": "rotated-secret-here",
"matching_event_types": ["bounce", "complaint"],
"enabled": true
}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
bash
curl -X PATCH \
https://api.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}'