Integration

Mailrelay integration

Mailrelay is an email, SMS and WhatsApp marketing platform. Manage subscribers, groups, tags and custom fields, import subscribers, create, test, send, pause and cancel email, RSS, SMS and WhatsApp campaigns, run A/B tests, read sent-campaign results (sent emails, opens, clicks, unsubscribes), send transactional SMTP emails, SMS and WhatsApp template messages, manage senders, WhatsApp templates and e-commerce stores, products and carts for automations, and read account stats and package. Sending tools deliver real messages to real people and SMS and WhatsApp spend the account's credits. Not exposed: API batches, the media file library and folders, event (webhook) subscriptions and the ping check; IP addresses, user agents and geolocation of opens and clicks, subscribers' street address, city and state, campaign public URL tokens, cart checkout links and callback URLs are not returned. Authentication is a Mailrelay API key (Settings, API keys) sent in the X-AUTH-TOKEN header, with your account domain (such as example.ipzmarketing.com) as the host. Rate limits per account: 1000 requests per minute for the send endpoints, 300 per minute for subscribers, 250 every 5 minutes for the rest.

Connect Mailrelay How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Mailrelay.Built from the 151 Mailrelay tools below, on the connection you add once.

What you can do with Mailrelay

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Subscriber, 7 operations

ban_subscriberBan subscriberPATCHBans a subscriber in this account. unban_subscriber lifts the ban. Id from list_subscribers.
bulk_update_subscribersBulk update subscribersPATCHRemoves many subscribers from a group in the background (bulk_action remove_from_group). Pass subscriber_ids, or all_subscribers true to affect every subscriber; not both.
create_subscriberCreate subscriberPOSTAdd a new subscriber Note that you should provide the default subscriber status.
delete_subscriberDelete subscriberDELETEDeletes a subscriber by id (id from list_subscribers). Deleted subscribers are listed by list_deleted_subscribers and can be brought back with restore_subscriber.
get_subscriberGet subscriberGETReturns one subscriber by id, as returned by list_subscribers.
list_subscribersList subscribersGETLists all subscribers. Paginated with page and per_page.
restore_subscriberRestore subscriberPATCHRestores a deleted subscriber, with the id from list_deleted_subscribers.

Ab test, 5 operations

cancel_ab_testCancel ab testPATCHCancels an A/B test for good: once cancelled it cannot be resumed.
create_ab_testCreate ab testPOSTAdd a new A/B test. At least 10 subscribers are required to send it. You have to choose the percentage of the subscribers that will receive the A/B test.
delete_ab_testDelete ab testDELETEDeletes a A/B test by id (id from list_ab_tests).
get_ab_testGet ab testGETReturns one A/B test by id, as returned by list_ab_tests.
list_ab_testsList ab testsGETLists A/B tests. Paginated with page and per_page.

Sent campaign, 5 operations

cancel_sent_campaignCancel sent campaignPATCHThis will stop and permanently cancel the campaign. It can't be resumed later.
get_sent_campaignGet sent campaignGETReturns one sent email campaign with its delivery counters by id, as returned by list_sent_campaigns.
list_sent_campaignsList sent campaignsGETLists sent campaigns. Paginated with page and per_page.
pause_sent_campaignPause sent campaignPATCHPauses an email campaign that is being sent; resume_sent_campaign continues it and cancel_sent_campaign stops it. Id from list_sent_campaigns.
resume_sent_campaignResume sent campaignPATCHResumes a paused email campaign, so the remaining emails go out for real. Id from list_sent_campaigns.

Sms sent campaign, 5 operations

cancel_sms_sent_campaignCancel sms sent campaignPATCHThis will stop and permanently cancel the campaign. It can't be resumed later.
get_sms_sent_campaignGet sms sent campaignGETReturns one sent SMS campaign by id, as returned by list_sms_sent_campaigns.
list_sms_sent_campaignsList sms sent campaignsGETLists SMS sent campaigns. Paginated with page and per_page.
pause_sms_sent_campaignPause sms sent campaignPATCHPauses an SMS campaign that is being processed; resume_sms_sent_campaign continues it. Id from list_sms_sent_campaigns.
resume_sms_sent_campaignResume sms sent campaignPATCHResumes a paused SMS campaign, so the remaining messages go out for real and spend credits. Id from list_sms_sent_campaigns.

Campaign, 4 operations

create_campaignCreate campaignPOSTCreates a campaign draft in the Mailrelay account and returns it with its new id.
delete_campaignDelete campaignDELETEDeletes a campaign draft by id (id from list_campaigns).
get_campaignGet campaignGETReturns one campaign draft by id, as returned by list_campaigns.
list_campaignsList campaignsGETLists campaigns. Paginated with page and per_page.

Campaign folder, 4 operations

create_campaign_folderCreate campaign folderPOSTCreates a campaign folder in the Mailrelay account and returns it with its new id.
delete_campaign_folderDelete campaign folderDELETEDeletes a campaign folder by id (id from list_campaign_folders).
get_campaign_folderGet campaign folderGETReturns one campaign folder by id, as returned by list_campaign_folders.
list_campaign_foldersList campaign foldersGETLists campaign folders. Paginated with page and per_page.

Custom field, 4 operations

create_custom_fieldCreate custom fieldPOSTCreates a custom field in the Mailrelay account and returns it with its new id.
delete_custom_fieldDelete custom fieldDELETE*Important!* Deleting a custom field will remove this field's data from all subscribers.
get_custom_fieldGet custom fieldGETReturns one custom field by id, as returned by list_custom_fields.
list_custom_fieldsList custom fieldsGETLists custom fields. Paginated with page and per_page.

Ecommerce cart, 4 operations

create_ecommerce_cartCreate ecommerce cartPOSTCreates a cart of a store in the Mailrelay account and returns it with its new id. Needs store_id from list_ecommerce_stores.
delete_ecommerce_cartDelete ecommerce cartDELETEDeletes a cart of a store by id (id from list_ecommerce_carts). Needs store_id from list_ecommerce_stores.
get_ecommerce_cartGet ecommerce cartGETReturns one cart of a store by id, as returned by list_ecommerce_carts. Needs store_id from list_ecommerce_stores.
list_ecommerce_cartsList ecommerce cartsGETLists carts. Paginated with page and per_page.

Ecommerce product, 4 operations

create_ecommerce_productCreate ecommerce productPOSTCreates a product of a store in the Mailrelay account and returns it with its new id. Needs store_id from list_ecommerce_stores.
delete_ecommerce_productDelete ecommerce productDELETEDeletes a product of a store by id (id from list_ecommerce_products). Needs store_id from list_ecommerce_stores.
get_ecommerce_productGet ecommerce productGETReturns one product of a store by id, as returned by list_ecommerce_products. Needs store_id from list_ecommerce_stores.
list_ecommerce_productsList ecommerce productsGETLists products. Paginated with page and per_page.

Ecommerce product category, 4 operations

create_ecommerce_product_categoryCreate ecommerce product categoryPOSTCreates a product category of a store in the Mailrelay account and returns it with its new id. Needs store_id from list_ecommerce_stores.
delete_ecommerce_product_categoryDelete ecommerce product categoryDELETEDeletes a product category of a store by id (id from list_ecommerce_product_categories). Needs store_id from list_ecommerce_stores.
get_ecommerce_product_categoryGet ecommerce product categoryGETReturns one product category of a store by id, as returned by list_ecommerce_product_categories. Needs store_id from list_ecommerce_stores.
list_ecommerce_product_categoriesList ecommerce product categoriesGETLists product categories. Paginated with page and per_page.

Ecommerce store, 4 operations

create_ecommerce_storeCreate ecommerce storePOSTCreates a e-commerce store in the Mailrelay account and returns it with its new id.
delete_ecommerce_storeDelete ecommerce storeDELETEDeletes a e-commerce store by id (id from list_ecommerce_stores).
get_ecommerce_storeGet ecommerce storeGETReturns one e-commerce store by id, as returned by list_ecommerce_stores.
list_ecommerce_storesList ecommerce storesGETLists ecommerce stores. Paginated with page and per_page.

Group, 4 operations

create_groupCreate groupPOSTCreates a subscriber group in the Mailrelay account and returns it with its new id.
delete_groupDelete groupDELETEDeletes a subscriber group by id (id from list_groups).
get_groupGet groupGETReturns one subscriber group by id, as returned by list_groups.
list_groupsList groupsGETLists groups. Paginated with page and per_page.

Import, 4 operations

cancel_importCancel importPATCHThis will stop and permanently cancel an import. It can't be resumed later.
create_importCreate importPOSTThis function should be used when you need to import a large number of subscribers and adding then individually is very slow.
get_importGet importGETReturns one subscriber import by id, as returned by list_imports.
list_importsList importsGETLists imports. Paginated with page and per_page.

Rss campaign, 4 operations

create_rss_campaignCreate rss campaignPOSTCreates a RSS campaign in the Mailrelay account and returns it with its new id.
delete_rss_campaignDelete rss campaignDELETEDeletes a RSS campaign by id (id from list_rss_campaigns).
get_rss_campaignGet rss campaignGETReturns one RSS campaign by id, as returned by list_rss_campaigns.
list_rss_campaignsList rss campaignsGETLists RSS campaigns. Paginated with page and per_page.

Sender, 4 operations

create_senderCreate senderPOSTCreates a sender (from address) in the Mailrelay account and returns it with its new id.
delete_senderDelete senderDELETEWhen removing a sender you *must* provide the ID of another confirmed sender.
get_senderGet senderGETReturns one sender (from address) by id, as returned by list_senders.
list_sendersList sendersGETLists senders. Paginated with page and per_page.

Sms campaign, 4 operations

create_sms_campaignCreate sms campaignPOSTCreates a SMS campaign draft in the Mailrelay account and returns it with its new id.
delete_sms_campaignDelete sms campaignDELETEDeletes a SMS campaign draft by id (id from list_sms_campaigns).
get_sms_campaignGet sms campaignGETReturns one SMS campaign draft by id, as returned by list_sms_campaigns.
list_sms_campaignsList sms campaignsGETLists SMS campaigns. Paginated with page and per_page.

Subscriber tag, 4 operations

add_subscriber_tagsAdd subscriber tagsPOSTAdds the given tags to a subscriber. Already assigned tags are ignored. Tags are matched by name and must already exist.
list_subscriber_tagsList subscriber tagsGETLists the tags assigned to one subscriber (subscriber_id from list_subscribers).
remove_subscriber_tagsRemove subscriber tagsDELETERemoves the given tags from a subscriber. Unknown or unassigned tag names are ignored.
replace_subscriber_tagsReplace subscriber tagsPUTReplaces the subscriber's full tag set with the given tags. An empty array removes all tags. Tags are matched by name and must already exist.

Tag, 4 operations

create_tagCreate tagPOSTCreates a tag in the Mailrelay account and returns it with its new id.
delete_tagDelete tagDELETERemove a tag. Removing a tag also unassigns it from all subscribers. A tag that is being used by an automation can't be removed.
get_tagGet tagGETReturns one tag by id, as returned by list_tags.
list_tagsList tagsGETLists tags. Paginated with page and per_page.

Unsubscribe event, 4 operations

create_unsubscribe_eventCreate unsubscribe eventPOSTRecords an unsubscribe for one sent email (sent_email_id); when that email belongs to a subscriber, the subscriber is set as unsubscribed.
delete_unsubscribe_eventDelete unsubscribe eventDELETERemove an unsubscribe event. Please, note that this method will only work if the unsubscribe event was created using the API. Unsubscribe events created elsewhere can't be removed.
get_unsubscribe_eventGet unsubscribe eventGETReturns one unsubscribe event by id, as returned by list_unsubscribe_events.
list_unsubscribe_eventsList unsubscribe eventsGETLists unsubscribe events. Paginated with page and per_page.

Whatsapp campaign, 4 operations

create_whatsapp_campaignCreate whatsapp campaignPOSTCreates a WhatsApp campaign draft in the Mailrelay account and returns it with its new id.
delete_whatsapp_campaignDelete whatsapp campaignDELETEDeletes a WhatsApp campaign draft by id (id from list_whatsapp_campaigns).
get_whatsapp_campaignGet whatsapp campaignGETReturns one WhatsApp campaign draft by id, as returned by list_whatsapp_campaigns.
list_whatsapp_campaignsList whatsapp campaignsGETLists WhatsApp campaigns. Paginated with page and per_page.

Whatsapp sent campaign, 4 operations

cancel_whatsapp_sent_campaignCancel whatsapp sent campaignPATCHThis will stop and permanently cancel the campaign. It can't be resumed later.
get_whatsapp_sent_campaignGet whatsapp sent campaignGETReturns one sent WhatsApp campaign by id, as returned by list_whatsapp_sent_campaigns.
list_whatsapp_sent_campaignsList whatsapp sent campaignsGETLists WhatsApp sent campaigns. Paginated with page and per_page.
pause_whatsapp_sent_campaignPause whatsapp sent campaignPATCHPauses a WhatsApp campaign that is being sent; resume_whatsapp_sent_campaign continues it. Id from list_whatsapp_sent_campaigns.

Whatsapp template, 4 operations

create_whatsapp_templateCreate whatsapp templatePOSTCreates a WhatsApp message template in DRAFT status. It can be used for sending only after submit_whatsapp_template_for_approval and approval.
delete_whatsapp_templateDelete whatsapp templateDELETEDeletes a WhatsApp message template by id (id from list_whatsapp_templates).
get_whatsapp_templateGet whatsapp templateGETGet a specific WhatsApp template with full details including components
list_whatsapp_templatesList whatsapp templatesGETLists all WhatsApp message templates. Paginated with page and per_page.

Whatsapp phone number, 3 operations

delete_whatsapp_phone_numberDelete whatsapp phone numberDELETERemove a WhatsApp phone number connection. Cannot delete if the phone number has active campaigns (pending, processing, or paused).
get_whatsapp_phone_numberGet whatsapp phone numberGETReturns one WhatsApp sender phone number of the account by id (id from list_whatsapp_phone_numbers).
list_whatsapp_phone_numbersList whatsapp phone numbersGETLists all connected WhatsApp phone numbers. Paginated with page and per_page.

Sms sent message, 2 operations

get_sms_sent_messageGet sms sent messageGETReturns one SMS message sent with send_sms, with its delivery state, by id.
list_sms_sent_messagesList sms sent messagesGETLists SMS sent messages. Paginated with page and per_page.

Smtp email, 2 operations

get_smtp_emailGet smtp emailGETReturns one transactional SMTP email with its opens and clicks by id, as returned by list_smtp_emails.
list_smtp_emailsList smtp emailsGETLists the transactional SMTP emails sent with send_emails, with their delivery state, opens and clicks, paginated with page and per_page.

Whatsapp sent message, 2 operations

get_whatsapp_sent_messageGet whatsapp sent messageGETReturns one transactional WhatsApp message sent with send_whatsapp_messages, with its delivery state, by id.
list_whatsapp_sent_messagesList whatsapp sent messagesGETLists WhatsApp transactional sent messages. Paginated with page and per_page.

Ab test winner, 1 operation

choose_ab_test_winning_combinationChoose ab test winning combinationPOSTWhen A/B test is manual, this method allows you to select which option should be sent to the remaining subscribers. Once you select it, we will start sending it immediately.

Account package, 1 operation

get_packageGet packageGETThis function can be used to retrieve information about your account's package.

Account stats, 1 operation

get_statsGet statsGETReturn the stats summary for the given time range. The maximum time range is 1 month.

Bounce, 1 operation

delete_bouncesDelete bouncesDELETERemoves email addresses from the bounces list and reactivates those subscribers, so email can be sent to them again.

Deleted subscriber, 1 operation

list_deleted_subscribersList deleted subscribersGETLists deleted subscribers. Paginated with page and per_page.

Import row, 1 operation

get_import_dataGet import dataGETGet line by line data of an import. Paginated with page and per_page.

Rss campaign entry, 1 operation

list_rss_campaign_processed_entriesList rss campaign processed entriesGETGet RSS campaign's processed entries. Paginated with page and per_page.

Sent campaign click, 1 operation

list_sent_campaign_clicksList sent campaign clicksGETGet sent campaign's clicks. Paginated with page and per_page.

Sent campaign impression, 1 operation

list_sent_campaign_impressionsList sent campaign impressionsGETGet sent campaign's impressions. Paginated with page and per_page.

Sent campaign sent email, 1 operation

list_sent_campaign_sent_emailsList sent campaign sent emailsGETThe default behavior is to only list sent emails without additional information like clicks, impressions or unsubscribe events.

Sent campaign unsubscribe event, 1 operation

list_sent_campaign_unsubscribe_eventsList sent campaign unsubscribe eventsGETGet sent campaign's unsubscribe events. Paginated with page and per_page.

Signup form, 1 operation

list_signup_formsList signup formsGETLists signup forms. Paginated with page and per_page.

Sms sent campaign sent message, 1 operation

list_sms_sent_campaign_sent_messagesList sms sent campaign sent messagesGETThe default behavior is to only list sent messages without additional information like unsubscribe events.

Sms sent campaign unsubscribe event, 1 operation

list_sms_sent_campaign_unsubscribe_eventsList sms sent campaign unsubscribe eventsGETGet SMS sent campaign's unsubscribe events. Paginated with page and per_page.

Smtp tag, 1 operation

list_smtp_tagsList smtp tagsGETLists SMTP tags. Paginated with page and per_page.

Subscriber confirmation email, 1 operation

resend_subscriber_confirmation_emailResend subscriber confirmation emailPOSTSends the confirmation email again, for real, to an inactive subscriber who has not confirmed yet. Id from list_subscribers.

Whatsapp sent campaign sent message, 1 operation

list_whatsapp_sent_campaign_sent_messagesList whatsapp sent campaign sent messagesGETGet WhatsApp sent campaign's sent messages. Paginated with page and per_page.

Showing the first 120 of 151 endpoints. The rest are in the product, searchable from the workflow builder and from chat.

Use Mailrelay from Claude Code, Cursor or Codex

Connect Mailrelay in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Mailrelay operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Mailrelay

Create your workspace
Sign up free. Nothing to install.
Connect Mailrelay once
Add your Mailrelay connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.