API Reference

Integrate SendWing into your applications with our REST API. Manage lists, subscribers, campaigns, and send transactional emails programmatically.

---

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

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"
    }
  ]
}

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"
  }
}

Method	Endpoint	Description
GET	/api/campaigns	List all campaigns
POST	/api/campaigns/{id}/send	Send a campaign

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.

---