Get started
API reference
One base URL, JSON in and out, snake_case fields, Bearer authentication. Every endpoint below links to its guide.
Basics#
- Base URL:
https://www.mailmanny.com/api/v1 - Authentication:
Authorization: Bearer mm_live_…(details) - Bodies are JSON with
Content-Type: application/json. Timestamps are ISO 8601 in UTC; ids are UUIDs. - Lists return
{ object: "list", data, has_more, next_cursor }. Pass?cursor=and?limit=(1–100) to page. - Errors return
{ statusCode, name, message }(all errors).
Emails#
EndpointPermission
Audiences & contacts#
EndpointPermission
- GET/api/v1
/audiencesList audiencescontacts:read - GET/api/v1
/audiences /{id}Get an audiencecontacts:read - POST/api/v1
/audiences /{id} /contactsAdd or update a contactcontacts:write - GET/api/v1
/audiences /{id} /contactsList contactscontacts:read - GET/api/v1
/audiences /{id} /contacts /{email_or_id}Get a contactcontacts:read - PATCH/api/v1
/audiences /{id} /contacts /{email_or_id}Update or unsubscribecontacts:write - DELETE/api/v1
/audiences /{id} /contacts /{email_or_id}Archive or erasecontacts:write - POST/api/v1
/audiences /{id} /contacts /{email_or_id} /tagsAdd and remove tagscontacts:write
Events#
EndpointPermission
Templates#
EndpointPermission