Developers

API reference

Mailbok exposes mail, conversations, contacts, domains, templates, and workflow track endpoints. Start with the getting started guide: create an API key, verify a domain, then send. Authenticate every /api/v1 request with Authorization: Bearer YOUR_API_KEY.

Quick start

Send with one call

curl -X POST https://www.mailbok.com/api/v1/emails \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": ["user@example.com"],
    "subject": "Hello",
    "html": "<p>Welcome!</p>"
  }'

Mail

Endpoints

POST/api/v1/emailsSend a transactional email
POST/api/v1/emails/batchSend up to 100 emails
GET/api/v1/emailsList sent emails
GET/api/v1/emails/:idGet email with event timeline
POST/api/v1/emails/:id/cancelCancel scheduled email
GET/api/v1/emails/receivingList inbound emails

Helpdesk

Endpoints

GET/api/v1/conversationsList helpdesk conversations
GET/api/v1/conversations/:idGet conversation timeline
POST/api/v1/conversations/:id/replyReply to a conversation
POST/api/v1/contactsCreate a contact
GET/api/v1/contactsList contacts

Platform

Endpoints

POST/api/v1/domainsAdd a sending domain
POST/api/v1/domains/:id/verifyCheck domain verification
GET/api/v1/templatesList templates
POST/api/v1/trackSend custom event for workflows
GET/api/v1/logsList API request logs
GET/api/v1/pricingPublic pricing catalog
POST/api/v1/dedicated-ipsRequest dedicated IP pool

SDK: npm install @mailbok/node

CLI: npx mailbok login

Create an account for your API key