Skip to main content
PUT
/
webhook
/
{identifier}
Update webhook
curl --request PUT \
  --url https://api.sendx.io/api/v1/rest/webhook/{identifier} \
  --header 'Content-Type: application/json' \
  --header 'X-Team-ApiKey: <api-key>' \
  --data '{
  "url": "https://api.example.com/webhooks/sendx",
  "enabled": true,
  "unsubscribed": false,
  "dropped": false,
  "bounced": false,
  "markedSpam": false,
  "clicked": false,
  "opened": false,
  "contactCreated": false
}'
{
  "enabled": true,
  "url": "https://new-api.example.com/webhooks/sendx",
  "unsubscribed": true,
  "dropped": true,
  "bounced": true,
  "markedSpam": true,
  "clicked": true,
  "opened": true,
  "contactCreated": true
}
🔄 Updatable fields:
  • Endpoint URL
  • Enabled/disabled status
  • Event subscriptions
⚠️ Important:
  • URL changes take effect immediately
  • Disabling pauses all deliveries
  • Event changes apply to future events only
💡 Common Updates:
  • Change endpoint URL
  • Enable/disable specific events
  • Temporarily pause webhook
  • Add new event types

Authorizations

​
X-Team-ApiKey
string
header
required

Team API key for authentication. Find your API key in SendX Settings → Team API Key.

Example:

X-Team-ApiKey: your_team_api_key_here

Path Parameters

​
identifier
string
required

Webhook identifier to update

Body

application/json
​
url
string<uri>
required

Webhook endpoint URL

Example:

"https://api.example.com/webhooks/sendx"

​
enabled
boolean
default:true
required

Whether webhook is enabled

​
unsubscribed
boolean
default:false

Trigger webhook when a contact unsubscribes

​
dropped
boolean
default:false

Trigger webhook when an email is dropped

​
bounced
boolean
default:false

Trigger webhook when an email bounces

​
markedSpam
boolean
default:false

Trigger webhook when an email is marked as spam

​
clicked
boolean
default:false

Trigger webhook when a link in the email is clicked

​
opened
boolean
default:false

Trigger webhook when an email is opened

​
contactCreated
boolean
default:false

Trigger webhook when a new contact is created

Response

✅ Webhook updated successfully

​
id
string
Example:

"webhook_9l154iiXlZoPo7vngmamee"

​
url
string<uri>

Webhook endpoint URL

Example:

"https://api.example.com/webhooks/sendx"

​
enabled
boolean
default:true

Whether webhook is enabled

​
unsubscribed
boolean
default:false

Trigger webhook when a contact unsubscribes

​
dropped
boolean
default:false

Trigger webhook when an email is dropped

​
bounced
boolean
default:false

Trigger webhook when an email bounces

​
markedSpam
boolean
default:false

Trigger webhook when an email is marked as spam

​
clicked
boolean
default:false

Trigger webhook when a link in the email is clicked

​
opened
boolean
default:false

Trigger webhook when an email is opened

​
contactCreated
boolean
default:false

Trigger webhook when a new contact is created

⌘I