SARE integration
SARE is a Polish email and SMS marketing platform. Add, edit, look up and delete subscribers and their custom properties, manage groups (lists) and group membership, import, list and read newsletter templates, send transactional or group emails and SMS, cancel scheduled mailings, manage the blacklist (activated by a SARE consultant), and read mailing, transactional email and SMS statistics and per-recipient delivery details. The vendor's deprecated lookups that put a raw email address or phone number in the URL are left out: use the hash or list lookups. Authentication is a New Rest API key (SARE panel, Advanced > API; none exists until you generate one) sent in the ApiKey header, plus the account UID that forms part of every request URL.
Say what should happen.
The workflow builds itself.
What you can do with SARE
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.
From to, 6 operations
get_sms_statsGet sms statsGETReturns grouped SMS statistics (all, sent, unsent, delivered, clicks, accepted, en route, expired, undeliverable, rejected) for a time range.get_transactional_email_statsGet transactional email statsGETReturns transactional email statistics for a time range, optionally for one campaign name, one page at a time.get_transactional_sms_statsGet transactional sms statsGETReturns transactional SMS statistics for a time range, one page at a time.list_smsList smsGETLists the individual SMS messages sent between two Unix timestamps, one page at a time (page starts at 0, read nextPage).list_transactional_emailsList transactional emailsGETLists individual transactional emails sent between two Unix timestamps, one page at a time (page starts at 0, read nextPage).list_transactional_smsList transactional smsGETLists individual transactional SMS sent between two Unix timestamps, one page at a time (page starts at 0, read nextPage).
List, 4 operations
list_blacklistList blacklistPOSTLists blacklist records of one type (email or domain), with optional search, sorting and paging (rowsPerPage default 100, page starts at 1). Needs the blacklist activated by a SARE consultant.list_groupsList groupsGETLists every group (subscriber list) of the account with its number, name, short name, description and privacy. Use the id as the group number in other tools.list_mailingsList mailingsGETLists the mailings sent between two Unix timestamps (id, campaign, template, groups, subject, date), one page at a time (page starts at 0, read nextPage).list_templatesList templatesGETLists newsletter templates of one type: ready (completed) or temporary (draft), one page at a time (page starts at 0, read nextPage).
Add, 3 operations
add_subscribersAdd subscribersPOSTAdds subscribers (email addresses with optional phone, status, groups, name and properties). By default a duplicate keeps its data and only its status is updated, and no confirmation email is sent; the flags change that.add_to_blacklistAdd to blacklistPOSTAdds email addresses or whole domains to the account blacklist; blacklisted addresses no longer receive mailings. The blacklist must first be activated by a SARE consultant.create_groupsCreate groupsPOSTCreates groups (subscriber lists). Each needs a free group number (list_free_group_numbers), a unique name and a unique short name of at most 5 characters.
By campaign, 3 operations
get_sms_stats_by_campaignGet sms stats by campaignGETReturns SMS statistics grouped by campaign for a time range, one page at a time.get_transactional_email_stats_by_campaignGet transactional email stats by campaignGETReturns transactional email statistics grouped by campaign for a time range, one page at a time.get_transactional_sms_stats_by_campaignGet transactional sms stats by campaignGETReturns transactional SMS statistics grouped by campaign for a time range, one page at a time.
From campaign, 3 operations
list_sms_by_campaignList sms by campaignGETLists the individual SMS messages of one SMS campaign (id from list_sms_campaigns), optionally between two Unix timestamps, one page at a time.list_transactional_emails_by_campaignList transactional emails by campaignGETLists individual transactional emails of one campaign name, optionally between two Unix timestamps, one page at a time.list_transactional_sms_by_campaignList transactional sms by campaignGETLists individual transactional SMS of one campaign name, optionally between two Unix timestamps, one page at a time.
By day, 2 operations
get_transactional_email_stats_by_dayGet transactional email stats by dayGETReturns transactional email statistics grouped by day for a time range, one page at a time.get_transactional_sms_stats_by_dayGet transactional sms stats by dayGETReturns transactional SMS statistics grouped by day for a time range, one page at a time.
Campaign, 2 operations
list_campaignsList campaignsGETLists mailing campaigns, optionally between two Unix timestamps, one page at a time (page starts at 0, read nextPage).list_sms_campaignsList sms campaignsGETLists SMS campaigns as a map of campaign id to name, one page at a time (page starts at 0, read nextPage).
Edit, 2 operations
update_groupsUpdate groupsPOSTEdits existing groups. The vendor requires id, name and short on every group, so read the current values with get_group or list_groups first and send them back with your change.update_subscribersUpdate subscribersPOSTEdits existing subscribers identified by email address: phone, status, groups, name, mail type, comment, basic, custom and consent properties.
From day, 2 operations
list_transactional_emails_by_dayList transactional emails by dayGETLists individual transactional emails sent on one day (d-m-Y, such as 24-12-2019), one page at a time.list_transactional_sms_by_dayList transactional sms by dayGETLists individual transactional SMS sent on one day (d-m-Y, such as 24-12-2019), one page at a time.
From email hash, 2 operations
list_mailings_for_subscriberList mailings for subscriberGETLists the individual mailings sent to one subscriber, found by the MD5 hash of its email (md5(salt + email), salt from list_properties), one page at a time.list_transactional_emails_for_subscriberList transactional emails for subscriberGETLists individual transactional emails sent to one address, found by the MD5 hash of the email (md5(salt + email), salt from list_properties), one page at a time.
From gsm hash, 2 operations
list_sms_for_phone_hashList sms for phone hashGETLists the individual SMS messages sent to one phone number, given as the MD5 hash of the number, one page at a time.list_transactional_sms_for_phone_hashList transactional sms for phone hashGETLists individual transactional SMS sent to one phone number, given as the MD5 hash of the number, one page at a time.
Info, 2 operations
get_blacklist_countsGet blacklist countsGETReturns how many email, domain and GSM records are on the account blacklists. The blacklist must first be activated by a SARE consultant.get_templateGet templateGETReturns the data of one newsletter template, ready (completed) or temporary (draft).
Remove, 2 operations
delete_groupDelete groupPOSTDeletes a group. Irreversible.remove_from_blacklistRemove from blacklistPOSTRemoves email addresses or domains from the account blacklist so they can receive mailings again. The blacklist must first be activated by a SARE consultant.
To group, 2 operations
send_email_to_groupsSend email to groupsPOSTSends a real email to every subscriber of the given groups; without a future time (Unix timestamp) treat it as sent now, and it cannot be recalled. Needs groups, subject, from, newsletter. cancel_mailings stops scheduled ones.send_sms_to_groupsSend sms to groupsPOSTSends real SMS to every subscriber of the given groups; without a future time (Unix timestamp) on an item, treat it as sent now, and sent messages cannot be recalled. Each object needs groups and txt.
Transactional, 2 operations
send_transactional_emailSend transactional emailPOSTSends real emails now, one per object in items, and they cannot be recalled: each needs email, subject, from and a template id or html/txt content.send_transactional_smsSend transactional smsPOSTSends real SMS now, one per object in items, and they cannot be recalled: each needs gsm (phone with country code) and txt.
Add email, 1 operation
add_subscribers_to_groupsAdd subscribers to groupsPOSTAdds existing subscribers, identified by email address, to one or more groups.
Add hash, 1 operation
add_hashes_to_groupsAdd hashes to groupsPOSTAdds existing subscribers, identified by the MD5 hash of their email (md5(salt + email), salt from list_properties), to one or more groups.
By email, 1 operation
get_transactional_email_stats_by_emailGet transactional email stats by emailGETReturns transactional email statistics grouped by recipient address for a time range, one page at a time.
By email hash, 1 operation
get_subscriber_by_hashGet subscriber by hashGETReturns a subscriber's data (email, phone, status, groups, name, properties, consents) by the MD5 hash of its email address. The hash is md5(salt + email); the salt is props_info.salt in list_properties.
By email list, 1 operation
lookup_subscribersLookup subscribersPOSTReturns subscriber data for a list of email addresses or phone numbers, one page at a time (page starts at 0, read nextPage).
By foreign key, 1 operation
find_subscribers_by_propertyFind subscribers by propertyGETFinds subscribers whose given property (for example prop4) equals a value, used as a foreign key from your own system. The route must first be activated by a SARE consultant.
By gsm, 1 operation
get_transactional_sms_stats_by_phoneGet transactional sms stats by phoneGETReturns transactional SMS statistics grouped by phone number for a time range, one page at a time.
By id, 1 operation
get_transactional_smsGet transactional smsGETReturns one transactional SMS by its sending id.
By shipment, 1 operation
get_sms_stats_by_shipmentGet sms stats by shipmentGETReturns SMS statistics grouped by shipment (sending) for a time range, one page at a time.
Cancel, 1 operation
cancel_mailingsCancel mailingsPOSTCancels scheduled mailings that have not been sent yet, by mailing id (as returned in send_email_to_groups).
Changed status, 1 operation
list_status_changesList status changesGETLists subscribers whose status changed between two Unix timestamps, one page at a time (page starts at 0, read nextPage).
Clear, 1 operation
clear_groupClear groupPOSTRemoves every subscriber from a group while keeping the group itself. Irreversible.
Click map, 1 operation
get_mailing_click_mapGet mailing click mapGETReturns the click map of a mailing as a PNG image file.
Delete, 1 operation
delete_subscribersDelete subscribersPOSTDeletes the given email addresses from the SARE database. Irreversible.
Email, 1 operation
list_group_subscribersList group subscribersGETLists the email addresses that belong to a group, one page at a time (page starts at 0, read nextPage).
Exist, 1 operation
check_blacklistCheck blacklistPOSTChecks whether each given email address or domain is on the account blacklist. The blacklist must first be activated by a SARE consultant.
Free, 1 operation
list_free_group_numbersList free group numbersGETLists the group numbers still free on the account; create_groups needs one of them as the id of a new group.
From shipment, 1 operation
list_sms_by_shipmentList sms by shipmentGETLists the individual SMS messages of one SMS shipment (sending), optionally between two Unix timestamps, one page at a time.
Get, 1 operation
get_groupGet groupGETReturns one group's details (number, name, short name, description, privacy) and its subscriber count.
Import, 1 operation
import_templateImport templatePOSTImports a newsletter template from a ZIP file as a ready or temporary (draft) template. The maximum size depends on the account settings.
List updated, 1 operation
list_updated_subscribersList updated subscribersGETLists subscribers whose status (updatedType=status) or group membership (updatedType=groups) changed in a time range, optionally only in some groups.
Prop, 1 operation
list_propertiesList propertiesGETLists the account's subscriber properties: basic prop1 to prop9 with their names, custom and special (consent) properties with details, consents, and the salt used to build email hashes.
Props custom add, 1 operation
create_propertyCreate propertyPOSTCreates a custom subscriber property of type string, list, int or spec_agr (consent). Its name is 1 to 32 characters: letters without Polish characters, digits, - or _, starting with a letter or digit.
Remove email, 1 operation
remove_subscribers_from_groupsRemove subscribers from groupsPOSTRemoves subscribers, identified by email address, from one or more groups.
Set ready, 1 operation
mark_template_readyMark template readyPOSTChanges a draft (temporary) template into a ready template.
Simple statistic, 1 operation
get_mailing_statisticsGet mailing statisticsGETReturns basic statistics of a mailing: sent, bounced, unsubscribed, opens, clicks, unique opens and unique clicks.
Status by email list, 1 operation
lookup_subscriber_statusesLookup subscriber statusesPOSTReturns the status of each of a list of email addresses or phone numbers, one page at a time (page starts at 0, read nextPage).
Status hash, 1 operation
get_subscriber_status_by_hashGet subscriber status by hashGETReturns only the numeric status of a subscriber found by the MD5 hash of its email address (md5(salt + email), salt from list_properties): 2 to 9, where 8 is confirmed.
Text, 1 operation
get_template_contentGet template contentGETReturns the HTML and text content of a template: ready, temporary (draft) or object (messages). fullPaths=1 returns full image paths.
Use SARE from Claude Code, Cursor or Codex
Connect SARE in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its SARE operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect SARE
- Create your workspace
Sign up free. Nothing to install.
- Connect SARE once
Add your SARE 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.
SARE integration FAQ
What can you do with the SARE integration?
LiveContext exposes 68 operations on SARE, covering from to, list, add and by campaign.
