Email campaigns, automations & direct mail — one smarter platform.
ZeSend/Developers
ZeSend API · v1

Connect any app to ZeSend.

A token-based REST API for lists, subscribers and campaigns — so any service that needs to send custom email campaigns can plug straight in. 52Forms and Leobri already do.

Getting started

All responses are JSON. Find your API token in Account Settings after you sign in.

Base URL
https://pro.zesend.com/api/v1
Authenticate — header (recommended)
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://pro.zesend.com/api/v1/lists
Authenticate — query parameter
curl "https://pro.zesend.com/api/v1/lists?api_token=YOUR_API_TOKEN"
Response format
{
  "status": 1,
  "message": "Success",
  "data": { ... }
}

Authentication

Get a token or a one-time login link.

POST/api/v1/user/loginGet API token using email and password
POST/api/v1/login-tokenGenerate one-time login token

Lists

Create and manage mailing lists and custom fields.

POST/api/v1/listsCreate a new list
GET/api/v1/listsGet all lists
GET/api/v1/lists/{uid}Get a specific list
POST/api/v1/lists/{uid}/add-fieldAdd a custom field to a list
DELETE/api/v1/lists/{uid}Delete a list

Campaigns

Create, run and report on campaigns.

GET/api/v1/campaignsGet all campaigns
POST/api/v1/campaignsCreate a campaign
GET/api/v1/campaigns/{uid}Get a specific campaign
PATCH/api/v1/campaigns/{uid}Update a campaign
POST/api/v1/campaigns/{uid}/runRun a campaign
POST/api/v1/campaigns/{uid}/pausePause a campaign
POST/api/v1/campaigns/{uid}/resumeResume a campaign
DELETE/api/v1/campaigns/{uid}Delete a campaign
GET/api/v1/campaigns/{uid}/tracking-log/downloadDownload tracking log
GET/api/v1/campaigns/{uid}/open-log/downloadDownload open log
GET/api/v1/campaigns/{uid}/click-log/downloadDownload click log
GET/api/v1/campaigns/{uid}/bounce-log/downloadDownload bounce log
GET/api/v1/campaigns/{uid}/feedback-log/downloadDownload feedback log
GET/api/v1/campaigns/{uid}/unsubscribe-log/downloadDownload unsubscribe log

Subscribers

Add, update, tag, import and unsubscribe contacts.

GET/api/v1/subscribersList a list's subscribers
POST/api/v1/subscribersCreate a subscriber in a list
GET/api/v1/subscribers/{id}Get a specific subscriber
PATCH/api/v1/subscribers/{id}Update a subscriber
POST/api/v1/subscribers/{id}/add-tagAdd tag(s) to a subscriber
POST/api/v1/subscribers/{id}/remove-tagRemove tag(s) from a subscriber
GET/api/v1/subscribers/email/{email}Find subscribers by email
PATCH/api/v1/lists/{list_uid}/subscribers/{id}/subscribeSubscribe a subscriber
PATCH/api/v1/lists/{list_uid}/subscribers/{id}/unsubscribeUnsubscribe a subscriber
PATCH/api/v1/lists/{list_uid}/subscribers/email/{email}/unsubscribeUnsubscribe by email
DELETE/api/v1/subscribers/{id}Delete a subscriber
POST/api/v1/lists/{list_uid}/subscribers/bulkBulk import (synchronous)
POST/api/v1/lists/{list_uid}/subscribers/bulk/asyncBulk import (queued)
GET/api/v1/lists/{list_uid}/import-jobsRecent import jobs for a list
GET/api/v1/import-jobs/{job_uid}Poll an import job
DELETE/api/v1/import-jobs/{job_uid}Cancel an import job

Notifications & feedback

Report bounces and complaints back to ZeSend.

POST/api/v1/notification/bounceReport a hard bounce
POST/api/v1/notification/feedbackReport a feedback or abuse complaint

Files

Upload assets to your account storage.

POST/api/v1/file/uploadUpload file(s) to storage

Admin API White Label

White Label partners also get admin endpoints to create and manage customer accounts, assign and change plans, manage subscriptions and read sending-server details — so you can provision ZeSend from your own software.

Customers

9 endpoints

Subscriptions

3 endpoints

Sending servers

1 endpoint

Authentication

1 endpoint

Talk to us about White Label

Full request and response examples for every endpoint are in the API Docs inside your ZeSend account.

Back to ZeSend home