API Reference
API Reference
Integrate SendWing into your applications with our REST API. Manage lists, subscribers, campaigns, and send transactional emails programmatically. 6Endpoints
Integrate SendWing into your applications with our REST API. Manage lists, subscribers, campaigns, and send transactional emails programmatically.
6
Endpoints
60
Req / Min
REST
Protocol
JSON
Format
Authentication
All requests require a Bearer token. Generate your API key from Settings > API Keys.
Authorization: Bearer your-api-key-here
Content-Type: application/json
Base URL
https://my.sendwing.com/api
Endpoints
Lists
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/lists | List all subscriber lists |
// Response
{
"data": [
{
"id": 1,
"uid": "abc123",
"name": "Newsletter",
"subscribers_count": 1250,
"created_at": "2026-01-15T10:30:00Z"
}
]
}
Subscribers
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/lists/{id}/subscribers | Get all subscribers |
| POST | /api/lists/{id}/subscribers | Add a subscriber |
| DEL | /api/lists/{id}/subscribers/{id} | Remove subscriber |
// Add a subscriber
POST /api/lists/1/subscribers
{
"email": "[email protected]",
"first_name": "Jane",
"last_name": "Smith",
"custom_fields": {
"company": "Acme Inc",
"plan": "pro"
}
}
Campaigns
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/campaigns | List all campaigns |
| POST | /api/campaigns/{id}/send | Send a campaign |
Transactional Email
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/transactional/send | Send transactional email |
POST /api/transactional/send
{
"to": "[email protected]",
"subject": "Your order confirmation",
"html": "<h1>Thank you!</h1>",
"from_name": "Acme Store",
"from_email": "[email protected]"
}
Response Codes
| Code | Meaning |
|---|---|
200 | Success |
201 | Resource created |
400 | Bad request - check parameters |
401 | Unauthorized - invalid API key |
404 | Resource not found |
422 | Validation error |
429 | Rate limit exceeded |
500 | Server error |
Webhooks
Receive real-time notifications when events occur. Configure in Settings > Webhooks.
Subscriber Events
subscriber.createdsubscriber.unsubscribed
Email Events
email.openedemail.clickedemail.bouncedemail.complained
Need a hand?
Our team is happy to help you get set up.