Mailrelay API Documentation

Introduction

Our API allows you to access several features of our application. It can be used to develop an integration, extend one of our features or obtain your account data.

Since it's a REST API, HTTP methods and status codes are important. Make sure that you always check the returned HTTP code in order to check if your request worked.

Authentication

The API key should be a sent as an HTTP header called X-AUTH-TOKEN. Here is an example using CURL:

curl -X GET --header 'X-AUTH-TOKEN: [YOUR-API-KEY]' 'https://[YOUR-ACCOUNT]/api/v1/groups'

Please, note that your should replace [YOUR-API-KEY] and [YOUR-ACCOUNT] in the example.

• Send emails
  • POST /send_emails — Send email to one or more recipients
• A/B tests
  • GET /ab_tests — Lists A/B tests
  • POST /ab_tests — Add a new A/B test
  • GET /ab_tests/{id} — Get an A/B test by id
  • DELETE /ab_tests/{id} — Remove an A/B test
  • PATCH /ab_tests/{id}/cancel — Cancel A/B test
  • POST /ab_tests/{id}/choose_winning_combination — Choose which A/B test combination should to be sent to the remaining subscribers
  • PATCH /ab_tests/{id}/set_as_manual — Set A/B test as manual
• Campaigns
  • GET /campaigns — Lists campaigns
  • POST /campaigns — Add a new campaign
  • GET /campaigns/{id} — Get a campaign by id
  • DELETE /campaigns/{id} — Remove a campaign
  • PATCH /campaigns/{id} — Update a campaign
  • POST /campaigns/{id}/send_all — Send a campaign
  • POST /campaigns/{id}/send_test — Send a campaign to test emails
• Campaign folders
  • GET /campaign_folders — Lists campaign folders
  • POST /campaign_folders — Add a new campaign folder
  • GET /campaign_folders/{id} — Get a campaign folder by id
  • DELETE /campaign_folders/{id} — Remove a campaign folder
  • PATCH /campaign_folders/{id} — Update a campaign folder
• Custom fields
  • GET /custom_fields — Lists custom fields
  • POST /custom_fields — Add a new custom field
  • GET /custom_fields/{id} — Get a custom field by id
  • DELETE /custom_fields/{id} — Remove a custom field
  • PATCH /custom_fields/{id} — Update a custom field
• Imports
  • GET /imports — Lists imports
  • POST /imports — Import a new file
  • GET /imports/{id} — Get a import by id
  • PATCH /imports/{id}/cancel — Cancel a import that is in progress
  • GET /imports/{id}/data — Get line by line data of a import
• Groups
  • GET /groups — Lists groups
  • POST /groups — Add a new group
  • GET /groups/{id} — Get a group by id
  • DELETE /groups/{id} — Remove a group
  • PATCH /groups/{id} — Update a group
• Media files
  • GET /media_files — Lists media files
  • POST /media_files — Add a new media file
  • GET /media_files/trashed — List media files in trash
  • GET /media_files/{id} — Get a single media file
  • DELETE /media_files/{id} — Hard delete a media file
  • PATCH /media_files/{id}/move_to_trash — Move media file to trash
  • PATCH /media_files/{id}/restore — Restore a file that is in trash
• Media folders
  • GET /media_folders — Lists media folders
  • POST /media_folders — Add a new media folder
  • GET /media_folders/{id} — Get a media folder by id
  • DELETE /media_folders/{id} — Remove a media folder
  • PATCH /media_folders/{id} — Update a media folder
• RSS Campaigns
  • GET /rss_campaigns — Lists RSS campaigns
  • POST /rss_campaigns — Add a new RSS campaign
  • GET /rss_campaigns/{id} — Get a RSS campaign by id
  • DELETE /rss_campaigns/{id} — Remove a RSS campaign
  • PATCH /rss_campaigns/{id} — Update a RSS campaign
  • GET /rss_campaigns/{id}/processed_entries — Get RSS campaign's processed entries
• Senders
  • GET /senders — Lists senders
  • POST /senders — Add a new sender
  • GET /senders/{id} — Get a sender by id
  • DELETE /senders/{id} — Remove a sender
  • PATCH /senders/{id} — Update a sender
  • POST /senders/{id}/send_confirmation_email — Send confirmation email
• Sent campaigns
  • GET /sent_campaigns — Lists sent campaigns
  • GET /sent_campaigns/{id} — Get a single sent campaign
  • GET /sent_campaigns/{id}/clicks — Get sent campaign's clicks
  • GET /sent_campaigns/{id}/impressions — Get sent campaign's impressions
  • GET /sent_campaigns/{id}/sent_emails — Get sent campaign's sent emails
  • GET /sent_campaigns/{id}/unsubscribe_events — Get sent campaign's unsubscribe events
  • PATCH /sent_campaigns/{id}/pause — Pause a campaign that is being sent
  • PATCH /sent_campaigns/{id}/resume — Resume a campaign that is paused
  • PATCH /sent_campaigns/{id}/cancel — Cancel a campaign
• SignupForms
  • GET /signup_forms — Lists signup forms
• SMTP emails
  • GET /smtp_emails — Get SMTP emails
  • GET /smtp_emails/{id} — Get an SMTP email by id
• SMTP tags
  • GET /smtp_tags — Lists SMTP tags
• Subscribers
  • GET /subscribers — Get subscribers
  • POST /subscribers — Add a new subscriber
  • GET /subscribers/{id} — Get a subscriber by id
  • DELETE /subscribers/{id} — Remove a subscriber
  • PATCH /subscribers/{id} — Update a subscriber
  • POST /subscribers/{id}/resend_confirmation_email — Resend confirmation email to an inactive subscriber
  • PATCH /subscribers/{id}/ban — Ban a subscriber
  • PATCH /subscribers/{id}/unban — Unban a subscriber
  • GET /subscribers/deleted — Get deleted subscribers
  • PATCH /subscribers/{id}/restore — Restore a deleted subscriber
  • POST /subscribers/sync — Create or update a subscriber
  • PATCH /subscribers/bulk_update — Bulk update subscribers
• Unsubscribe events
  • GET /unsubscribe_events — Lists unsubscribe events
  • POST /unsubscribe_events — Add a new unsubscribe event
  • GET /unsubscribe_events/{id} — Get an unsubscribe event by id
  • DELETE /unsubscribe_events/{id} — Remove an unsubscribe event
• Bounces
  • DELETE /bounces — Delete bounces
• General
  • GET /stats — Get stats summary
  • GET /package — Get account package info
  • GET /ping — Ping the API
• API batches
  • GET /api_batches — Lists API batches
  • POST /api_batches — Add a new API batch
  • GET /api_batches/{id} — Get an API batch by id
• Event Subscriptions
  • GET /event_subscriptions — Lists event subscriptions
  • POST /event_subscriptions — Add a new event subscription
  • GET /event_subscriptions/{id} — Get an event subscription by id
  • DELETE /event_subscriptions/{id} — Remove an event subscription
  • PATCH /event_subscriptions/{id} — Update an event subscription
• Send transactional SMS
  • POST /sms/send — Send SMS to one or more recipients
• SMS campaigns
  • GET /sms/campaigns — Lists SMS campaigns
  • POST /sms/campaigns — Add a new SMS campaign
  • GET /sms/campaigns/{id} — Get SMS campaign by id
  • DELETE /sms/campaigns/{id} — Remove SMS campaign
  • PATCH /sms/campaigns/{id} — Update SMS campaign
  • POST /sms/campaigns/{id}/send_all — Send SMS campaign
• SMS sent campaigns
  • GET /sms/sent_campaigns — Lists SMS sent campaigns
  • GET /sms/sent_campaigns/{id} — Get a single SMS sent campaign
  • GET /sms/sent_campaigns/{id}/sent_messages — Get SMS sent campaign's sent messages
  • GET /sms/sent_campaigns/{id}/unsubscribe_events — Get SMS sent campaign's unsubscribe events
  • PATCH /sms/sent_campaigns/{id}/pause — Pause a SMS campaign that is being processed
  • PATCH /sms/sent_campaigns/{id}/resume — Resume a SMS campaign that is paused
  • PATCH /sms/sent_campaigns/{id}/cancel — Cancel a SMS campaign
• SMS sent messages
  • GET /sms/sent_messages — Lists SMS sent messages
  • GET /sms/sent_messages/{id} — Get a single SMS sent message
• Ecommerce Stores
  • GET /ecommerce/stores — Lists ecommerce stores
  • POST /ecommerce/stores — Add a new ecommerce store
  • GET /ecommerce/stores/{id} — Get an ecommerce store by id
  • DELETE /ecommerce/stores/{id} — Remove an ecommerce store
  • PATCH /ecommerce/stores/{id} — Update an ecommerce store
• Ecommerce Product Categories
  • GET /ecommerce/stores/{store_id}/product_categories — Lists product categories
  • POST /ecommerce/stores/{store_id}/product_categories — Add a new product category
  • GET /ecommerce/stores/{store_id}/product_categories/{id} — Get a product category by id
  • DELETE /ecommerce/stores/{store_id}/product_categories/{id} — Remove a product category from a store
  • PATCH /ecommerce/stores/{store_id}/product_categories/{id} — Update a product category
  • POST /ecommerce/stores/{store_id}/product_categories/sync — Create or update a product category
• Ecommerce Products
  • GET /ecommerce/stores/{store_id}/products — Lists products
  • POST /ecommerce/stores/{store_id}/products — Add a new product
  • GET /ecommerce/stores/{store_id}/products/{id} — Get a product by id
  • DELETE /ecommerce/stores/{store_id}/products/{id} — Remove a product
  • PATCH /ecommerce/stores/{store_id}/products/{id} — Update a product
  • POST /ecommerce/stores/{store_id}/products/sync — Create or update a product
• Ecommerce Carts
  • GET /ecommerce/stores/{store_id}/carts — Lists carts
  • POST /ecommerce/stores/{store_id}/carts — Add a new cart
  • GET /ecommerce/stores/{store_id}/carts/{id} — Get a cart by id
  • DELETE /ecommerce/stores/{store_id}/carts/{id} — Remove a cart
  • PATCH /ecommerce/stores/{store_id}/carts/{id} — Update a cart
  • POST /ecommerce/stores/{store_id}/carts/sync — Create or update a cart
• Send transactional WhatsApp messages
  • POST /whatsapp/send — Send WhatsApp messages to one or more recipients
• WhatsApp Phone Numbers
  • GET /whatsapp/phone_numbers — Lists WhatsApp phone numbers
  • GET /whatsapp/phone_numbers/{id} — Get a WhatsApp phone number by id
  • DELETE /whatsapp/phone_numbers/{id} — Remove a WhatsApp phone number
• WhatsApp Templates
  • GET /whatsapp/templates — Lists WhatsApp templates
  • POST /whatsapp/templates — Create a new WhatsApp template
  • GET /whatsapp/templates/{id} — Get a WhatsApp template by id
  • DELETE /whatsapp/templates/{id} — Delete a WhatsApp template
  • PATCH /whatsapp/templates/{id} — Update a WhatsApp template
  • POST /whatsapp/templates/{id}/submit_for_approval — Submit template for approval
• WhatsApp campaigns
  • GET /whatsapp/campaigns — Lists WhatsApp campaigns
  • POST /whatsapp/campaigns — Add a new WhatsApp campaign
  • GET /whatsapp/campaigns/{id} — Get WhatsApp campaign by id
  • DELETE /whatsapp/campaigns/{id} — Remove WhatsApp campaign
  • PATCH /whatsapp/campaigns/{id} — Update WhatsApp campaign
  • POST /whatsapp/campaigns/{id}/send_all — Send WhatsApp campaign
• WhatsApp sent campaigns
  • GET /whatsapp/sent_campaigns — Lists WhatsApp sent campaigns
  • GET /whatsapp/sent_campaigns/{id} — Get a single WhatsApp sent campaign
  • GET /whatsapp/sent_campaigns/{id}/sent_messages — Get WhatsApp sent campaign's sent messages
  • PATCH /whatsapp/sent_campaigns/{id}/pause — Pause a WhatsApp campaign that is being sent
  • PATCH /whatsapp/sent_campaigns/{id}/resume — Resume a WhatsApp campaign that is paused
  • PATCH /whatsapp/sent_campaigns/{id}/cancel — Cancel a WhatsApp campaign
• WhatsApp sent messages
  • GET /whatsapp/sent_messages — Lists WhatsApp sent messages
  • GET /whatsapp/sent_messages/{id} — Get a single WhatsApp sent message