Skip to content
Splashify Pro
Email docsEmail

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:

  1. Generate a new secret on your side (openssl rand -hex 32)
  2. Update your endpoint to accept both old and new secrets for ~30 seconds
  3. PATCH this endpoint with the new secret
  4. Wait until in-flight requests drain (~30 seconds)
  5. 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}'