Delete Sender ID
Permanently remove a sender ID from your business. Only allowed if it has never been used to send a message or run a campaign.
Blocked If In Use
A sender ID with any linked messages or campaigns can't be deleted — this protects your send history from silently losing its "from" identity.
Authentication Required
Use Basic Authwith the precomputed Base64 token from your dashboard, set in the `Authorization` header as `Basic <token>`.
This action is irreversible
There is no undo. If you might want the name back later, leave it and simply stop sending with it instead of deleting it.
DELETE
/v1/sender-ids/:id
Stable
Path Parameters
| Parameter | Description |
|---|---|
| id | The sender ID's record id, from the create or list response |
Response
JSON
{"success": true,"message": "Sender ID deleted successfully"}
Try It Yourself
DELETE
https://api.sendexa.co/v1/sender-ids/SENDER_ID_IDCode Examples
Bash
curl -X DELETE 'https://api.sendexa.co/v1/sender-ids/SENDER_ID_ID' \-H 'Authorization: Basic YOUR_DASHBOARD_BASE64_TOKEN'
HTTP Status Codes
| Code | Status | Description |
|---|---|---|
| 200 | OK | Sender ID deleted |
| 400 | Bad Request | Sender ID is in use by messages or campaigns |
| 401 | Unauthorized | Invalid or missing API credentials |
| 403 | Forbidden | Sender ID belongs to a different business |
| 404 | Not Found | No sender ID with that id |
Best Practices
- Check the list endpoint's
stats.totalMessages/totalCampaignsbefore attempting a delete - Delete PENDING or REJECTED registrations you no longer need rather than leaving clutter