Developers
API Reference
A RESTful JSON API secured with API keys. Authenticate with a Bearer token, send emails, manage contacts, and listen to events via webhooks.
Base URL
https://artmail.io/api/v1Transactional Email
POST
/v1/emails/sendSend a transactional email with inline content
POST
/v1/emails/send-templateSend using a transactional template slug and variables
Contacts
GET
/v1/contactsList contacts with pagination and filters
POST
/v1/contactsCreate or update a contact
DELETE
/v1/contacts/:idRemove a contact permanently
Templates
GET
/v1/templatesList transactional templates
GET
/v1/templates/:slugGet template by slug with variable schema
Webhooks
GET
/v1/webhooksList registered webhook endpoints
POST
/v1/webhooksRegister a new webhook endpoint
DELETE
/v1/webhooks/:idDelete a webhook endpoint
Analytics
GET
/v1/campaigns/:id/statsGet campaign performance stats
GET
/v1/eventsQuery email events (sent, opened, clicked, bounced)