NewsMAN integration
NewsMAN is an email and SMS marketing platform. Manage lists, subscribers, tags and segments, import subscribers in bulk, create, schedule and track email newsletters and SMS campaigns, send transactional emails, single SMS and WhatsApp messages, manage coupons, product feeds and shop orders for remarketing, read automation workflows and set list webhooks. Not exposed: A/B tests, drafts, integration settings, CSV export links, list moderators and IPs, whole-segment mass anonymise, deactivate or unsubscribe, raw MIME sending, product groups, WhatsApp template drafts, mappings and catalog sync, and the reads that answer a bare number or flag (subscriber counts, SMS credit balance, profiling flag). Every error comes back as HTTP 400 with an error code; rate limit 1000 calls per minute per account. Authentication is a Bearer token: your user id and API key joined by a dash, shown under Account, API.
Say what should happen.
The workflow builds itself.
What you can do with NewsMAN
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.
Newsletter, 11 operations
cancel_newsletterCancel newsletterPOSTCancels a newsletter. Check the allowed actions first with get_newsletter_status.confirm_newsletterConfirm newsletterPOSTSends a newsletter (real emails to its segments): confirms an unconfirmed newsletter so NewsMAN can send it. Check the allowed actions first with get_newsletter_status.create_newsletterCreate newsletterPOSTCreates an unconfirmed newsletter on a list from HTML and/or text and props (subject required). Nothing is sent until confirm_newsletter. The new id is not passed on: read it with list_newsletters (status 0).get_newsletter_settingsGet newsletter settingsGETReturns the properties of a newsletter: subject (plain and base64), encoding and short URL.get_newsletter_statusGet newsletter statusGETReturns the status of a newsletter and the actions allowed now (confirm, schedule, cancel, pause...). Read it before changing a newsletter.list_newslettersList newslettersGETLists the newsletters of a list created in a period, with status, subject, segments, stats and report links. Filter by status (all, -1 cancelled, 0 unconfirmed, 1 confirmed, 2 sending, 3 paused, 4 resumed, 5 sent).pause_newsletterPause newsletterPOSTPauses a newsletter that is sending.restart_newsletterRestart newsletterPOSTSends a cancelled or already sent newsletter again (real emails): restarts it.resume_newsletterResume newsletterPOSTSends the rest of a paused newsletter (real emails): resumes it.schedule_newsletterSchedule newsletterPOSTSends a newsletter later (real emails to its segments): sets the UTC date and time at which NewsMAN sends it.send_test_newsletterSend test newsletterPOSTSends a test email with the given subject, HTML and text to the given addresses, from a list.
Sms campaign, 10 operations
cancel_sms_campaignCancel sms campaignPOSTCancels an SMS campaign.confirm_sms_campaignConfirm sms campaignPOSTSends an SMS campaign (real, billed SMS to its segments): confirms an unconfirmed SMS campaign so NewsMAN can send it. Check the allowed actions first with get_sms_campaign_status.create_sms_campaignCreate sms campaignPOSTCreates an unconfirmed SMS campaign on an SMS list from a text and props (subject required). Nothing is sent until confirm_sms_campaign. The new id is not passed on: read it with list_sms_campaigns (status 0).get_sms_campaign_settingsGet sms campaign settingsGETReturns the properties of an SMS campaign: subject (plain and base64), encoding and short URL.get_sms_campaign_statusGet sms campaign statusGETReturns the status of an SMS campaign and the actions allowed now (confirm, schedule, cancel...).list_sms_campaignsList sms campaignsGETLists the SMS campaigns of an SMS list created in a period, with status, subject, segments, stats and report links. Filter by status like list_newsletters.pause_sms_campaignPause sms campaignPOSTPauses an SMS campaign that is sending.restart_sms_campaignRestart sms campaignPOSTSends a cancelled or already sent SMS campaign again (real, billed SMS): restarts it.resume_sms_campaignResume sms campaignPOSTSends the rest of a paused SMS campaign (real, billed SMS): resumes it.schedule_sms_campaignSchedule sms campaignPOSTSends an SMS campaign later (real, billed SMS to its segments): sets the UTC date and time at which NewsMAN sends it.
Subscriber, 9 operations
add_subscriberAdd subscriberPOSTSubscribes an email to a list directly (no confirmation email) with name, IP and props; tag_ prefixed props set tags. The new id is not passed on: read it with get_subscriber_by_email.anonymise_list_subscriberAnonymise list subscriberPOSTAnonymises a subscriber of a list by subscriber_id: NewsMAN describes it as deleting the subscriber from the list. Cannot be undone.anonymise_subscriberAnonymise subscriberPOSTAnonymises a subscriber of a list, found by subscriber_id (removes personal data). Cannot be undone.anonymise_subscriber_by_emailAnonymise subscriber by emailPOSTAnonymises a subscriber of a list, found by email (removes personal data). Cannot be undone.get_subscriberGet subscriberGETReturns a subscriber by subscriber_id: email, status, subscribe date, name, IP, list, props and segments.get_subscriber_by_emailGet subscriber by emailGETReturns the subscriber of a list with this email: subscriber_id, status, subscribe date, name, IP, props and segments.get_subscribers_batchGet subscribers batchGETReturns several subscribers of a list at once, found by email or subscriber_id, with the same fields as get_subscriber.list_subscribersList subscribersGETLists the subscribers of a list with a given status (subscribed, unsubscribed, bounced, spam, inactivated), page by page, up to 1000 per page. Start at page 0 and go page by page.search_subscribersSearch subscribersGETSearches the subscribers of a list by keywords and status, page by page, up to 1000 per page.
Segment, 7 operations
clear_segmentClear segmentPOSTRemoves all subscribers from a segment.create_segmentCreate segmentPOSTCreates an empty segment on a list. The new id is not passed on: read it with list_segments or search_segments.delete_segmentDelete segmentPOSTDeletes a segment.list_segmentsList segmentsGETLists the segments of a list (or several lists, or all) with their segment_id, name, subscriber count and status. Rate limit 20 calls per minute.refresh_segmentRefresh segmentPOSTTriggers a refresh of a segment; list_segments shows its status (2 while the count is computed).rename_segmentRename segmentPOSTRenames a segment.search_segmentsSearch segmentsGETLists the segments of a list whose name matches a regular expression, with id, name, count and status.
Coupon, 5 operations
create_couponCreate couponPOSTCreates a coupon on a list, either import (you upload the codes) or api (NewsMAN generates codes on demand), with its expiry rule. Returns the stored coupon, including its id.delete_couponDelete couponPOSTSchedules the deletion of a coupon. Runs in the background.get_couponGet couponGETReturns one coupon of a list by id: type, status, expiry rule, total and available code counts, history and type settings.get_coupon_by_nameGet coupon by nameGETReturns one coupon of a list by its name: type, status, expiry rule, code counts, history and type settings.list_couponsList couponsGETLists every coupon of a list with its id, name, type, status, expiry rule and code counts.
Feed, 5 operations
create_feedCreate feedPOSTAdds a product feed to a list from a feed URL and type (Google Shopping, Facebook, Criteo...), or a fixed feed by name. The new id is not passed on: read it with list_feeds.delete_feedDelete feedPOSTDeletes a product feed from a list.get_feedGet feedGETReturns one product feed of a list: name, type, URL, product count, refresh settings, last parse status, errors and history.list_feedsList feedsGETLists the product feeds of a list with their id, name, type, product count, refresh settings and last parse status.refresh_feedRefresh feedPOSTStarts a refresh (download and parse) of a product feed. Runs in the background; check the result with get_feed.
Subscriber import, 5 operations
get_import_statusGet import statusGETReturns the state of a subscriber import (new, running, finished or error), its timestamps, total rows and counts of new, updated, duplicate and refused rows.import_subscribers_csvImport subscribers csvPOSTImports subscribers from CSV text (header row with email, comma delimited, UTF-8) into a list, in the background. Rate limit 30 calls per hour. The import id is not passed on; use import_subscribers_jsonl to follow an import.import_subscribers_jsonlImport subscribers jsonlPOSTImports subscribers given as JSON lines (one JSON object with an email per line, up to 100000 lines) into a list, in the background, one task per 20000 lines. Returns the import ids for get_import_status. 30 calls per hour.schedule_subscribers_csv_importSchedule subscribers csv importPOSTSame as import_subscribers_csv, but the import starts after delay seconds. Rate limit 30 calls per hour. The import id is not passed on by this tool.schedule_subscribers_jsonl_importSchedule subscribers jsonl importPOSTSame as import_subscribers_jsonl, but the imports start after delay seconds (0 starts at once). Up to 100000 lines per call. Rate limit 30 calls per hour.
Transactional template, 5 operations
delete_transactional_templateDelete transactional templatePOSTDeletes a transactional template.get_transactional_templateGet transactional templateGETReturns one transactional template: type (text or html) and content.list_transactional_templatesList transactional templatesGETReturns the transactional templates of the SMTP account tied to a list, as one object keyed by template id, each with type and content.render_transactional_templateRender transactional templateGETRenders a stored transactional template with the given parameters (handlebars) and returns the resulting content, without sending anything.save_transactional_templateSave transactional templatePOSTSaves a transactional template (text or html) under the template_id you give.
Confirmation template, 4 operations
create_confirmation_templateCreate confirmation templatePOSTCreates a subscribe or unsubscribe confirmation email template on a list, used by start_subscribe_confirmation and start_unsubscribe_confirmation. The new id is not passed on: read it with list_confirmation_templates.delete_confirmation_templateDelete confirmation templatePOSTDeletes a confirmation email template.get_confirmation_templateGet confirmation templateGETReturns a confirmation email template: list, type, subject, text and HTML.list_confirmation_templatesList confirmation templatesGETReturns the ids of the confirmation email templates of a list, for a type or all, as a plain list.
Coupon code, 4 operations
clear_coupon_codesClear coupon codesPOSTSchedules the removal of every code of a coupon. Runs in the background; the coupon itself is kept.generate_coupon_codesGenerate coupon codesPOSTSchedules the generation of new codes for an api-type coupon. Runs in the background; follow progress with get_coupon (available_codes, history).import_coupon_codesImport coupon codesPOSTSchedules the import of your own codes into a coupon, up to 20000 codes per call. Runs in the background.list_coupon_codesList coupon codesGETLists the codes of a coupon, page by page, optionally filtered by code, status (any, available, sent, expired) or recipient email. Each code says whether and to whom it was sent.
Feed product, 4 operations
add_feed_productsAdd feed productsPOSTAdds products to a fixed (hand-picked) feed by product id; the products must exist in a dynamic feed of the list. NewsMAN answers with the new product count, which this tool does not pass on.list_feed_productsList feed productsGETLists the products of a feed, at most 5000 per call, with title, price, currency, discount, stock, image, URL and brand. Page with start and limit.remove_feed_productsRemove feed productsPOSTRemoves products from a fixed (hand-picked) feed by product id. NewsMAN answers with the new product count, which this tool does not pass on.replace_feed_productsReplace feed productsPOSTReplaces every product of a fixed (hand-picked) feed with the given product ids; the products must exist in a dynamic feed of the list.
List, 4 operations
list_listsList listsGETLists every list of the account with its list_id, name and type (newsletter, sms...). Start here: most other tools need a list_id.list_lists_with_sitesList lists with sitesGETSame as list_lists, plus the website URL tied to each list (site_url).list_sms_listsList sms listsGETLists the SMS lists of the account with list_id, name and type. SMS tools need one of these list ids.rename_listRename listPOSTRenames a list.
Subscriber activity, 4 operations
get_subscriber_historyGet subscriber historyGETReturns the last 100 actions of a subscriber (send, view, click, bounce, spam, subscribe, unsubscribe) with date and metadata such as the newsletter.list_list_activityList list activityGETLists recent subscriber actions on a list (send, view, click, bounce, spam, unsubscribe), newest first, up to 5000 per call. Page by passing the last timestamp as before_timestamp.list_newsletter_activityList newsletter activityGETLists subscriber actions on a newsletter (send, view, click, bounce, spam, unsubscribe), newest first, up to 5000 per call. Page by passing the last timestamp as before_timestamp.list_sms_campaign_activityList sms campaign activityGETLists subscriber actions on an SMS campaign, newest first, up to 5000 per call. Page by passing the last timestamp as before_timestamp.
Subscriber tag, 4 operations
add_subscriber_tagAdd subscriber tagPOSTAdds one tag to a subscriber.add_subscriber_tagsAdd subscriber tagsPOSTAdds several tags to a subscriber in one call.remove_subscriber_tagRemove subscriber tagPOSTRemoves one tag from a subscriber.remove_subscriber_tagsRemove subscriber tagsPOSTRemoves several tags from a subscriber in one call.
Email reject status, 3 operations
add_email_reject_statusAdd email reject statusPOSTMarks an email address with a reject status (unsub, spam, bounce, hardbounce) so transactional emails to it are refused.get_email_reject_statusGet email reject statusGETReturns the reject counters of an email address (unsub, hardbounce, spam, bounce); one unsub, spam or hardbounce, or more than 10 bounces, makes sends to it rejected.remove_email_reject_statusRemove email reject statusPOSTClears reject statuses of an email address (ALL, or chosen types) so transactional emails to it are accepted again.
Segment subscriber, 3 operations
add_subscriber_to_segmentAdd subscriber to segmentPOSTAdds a subscriber to a segment.list_segment_subscribersList segment subscribersGETLists the subscribers of a segment (subscriber_id and email), page by page, up to 1000 per page.remove_subscriber_from_segmentRemove subscriber from segmentPOSTRemoves a subscriber from a segment.
Transactional tag, 3 operations
create_transactional_tagCreate transactional tagPOSTCreates a tag on the transactional SMTP account, used to group sent emails in stats.delete_transactional_tagDelete transactional tagPOSTDeletes a tag from the transactional SMTP account. Returns whether it was found and deleted.list_transactional_tagsList transactional tagsGETReturns the tag names of the transactional SMTP account tied to a list, as a plain list.
Newsletter segment, 2 operations
list_newsletter_excluded_segmentsList newsletter excluded segmentsGETReturns the ids of the segments excluded from a newsletter, as a plain list.list_newsletter_segmentsList newsletter segmentsGETReturns the ids of the segments a newsletter is sent to, as a plain list.
Newsletter stats, 2 operations
get_newsletter_statsGet newsletter statsGETReturns the stats of a newsletter: sends, send speed, views, clicks, unsubscribes, bounces, spam reports, social shares, status and report links.list_newsletter_link_clicksList newsletter link clicksGETLists the links clicked in a newsletter with their click count and last click time.
Order, 2 operations
save_orderSave orderPOSTRecords one website order (buyer, totals, currency, products) for the list linked to the website, for remarketing and revenue stats. Not counted against the rate limit.save_ordersSave ordersPOSTSchedules the saving of up to 5000 website orders at once; only orders with valid data are saved. Returns, per order number, whether it was saved and its errors.
Sms campaign segment, 2 operations
list_sms_campaign_excluded_segmentsList sms campaign excluded segmentsGETReturns the ids of the segments excluded from an SMS campaign, as a plain list.list_sms_campaign_segmentsList sms campaign segmentsGETReturns the ids of the segments an SMS campaign is sent to, as a plain list.
Sms campaign stats, 2 operations
get_sms_campaign_statsGet sms campaign statsGETReturns the stats of an SMS campaign: sends, send speed, clicks, unsubscribes, status and report links.list_sms_campaign_link_clicksList sms campaign link clicksGETLists the links clicked in an SMS campaign with their click count and last click time.
Subscriber variable, 2 operations
list_subscriber_variablesList subscriber variablesGETLists the custom subscriber fields (variables) defined on a list, with their name and type.refresh_subscriber_variablesRefresh subscriber variablesPOSTAsks NewsMAN to recompute the custom subscriber variables of a list.
Transactional event, 2 operations
list_email_historyList email historyGETLists transactional email events for one recipient address, newest first, 50 to 10000 per call.list_transactional_historyList transactional historyGETLists transactional email events of the SMTP account tied to a list (send, view, click, unsub, bounce, spam, reject), newest first, 50 to 10000 per call.
Transactional stats, 2 operations
get_transactional_statsGet transactional statsGETReturns transactional email stats of the SMTP account tied to a list between two dates, per day or hour: send, view, click, bounce, hardbounce, spam, unsub, reject.get_transactional_tag_statsGet transactional tag statsGETReturns transactional email stats for one tag between two dates, per day or hour, with the same counters as get_transactional_stats.
Webhook, 2 operations
delete_list_webhookDelete list webhookPOSTRemoves the webhook settings of a list.get_list_webhookGet list webhookGETReturns the webhook URL of a list and the events it receives.
Whatsapp template, 2 operations
get_whatsapp_templateGet whatsapp templateGETReturns one WhatsApp template of a list by exact name: body text, variables, category, language and approval status.list_whatsapp_templatesList whatsapp templatesGETLists the WhatsApp templates of a list from Meta, optionally by status (approved, pending, rejected).
Workflow, 2 operations
get_workflowGet workflowGETReturns one automation workflow by workflow_id: name, type, status, recurrence, preview links, general stats and per-trigger stats.list_workflowsList workflowsGETLists the automation workflows of a list, filtered by name, type, status (all, 0 inactive, 1 active) and the period they were last updated in. Returns each workflow with its id, type, status and stats.
Cart, 1 operation
clear_cartClear cartPOSTClears the remarketing shopping cart of a buyer (by email) on the website linked to a list. Returns no error even when the list is not accessible.
List settings, 1 operation
get_list_settingsGet list settingsGETReturns the settings of a list: sender email and name, owner details, site name and URL, link parameters appended to every link and send rate text.
List stats, 1 operation
get_list_subscriber_evolutionGet list subscriber evolutionGETReturns, day by day, the total and eligible subscriber counts of a list with its unsubscribes, spam reports and hard bounces. Pick the period with start_date and stop_date, days, or month.
Remarketing settings, 1 operation
get_remarketing_settingsGet remarketing settingsGETReturns the remarketing settings of a list: site id, hostname, form id, the tracking JavaScript and whether a data layer is used. Not counted against the rate limit.
Sms, 1 operation
send_smsSend smsPOSTSends one text SMS to one phone number from an SMS list, at once (billed). Returns the send_id and its status (e.g. queued). Not counted against the rate limit.
Sms subscriber, 1 operation
get_sms_subscriberGet sms subscriberGETReturns an SMS list subscriber by telephone number: id, status, dates, name, IP, props and segments.
Whatsapp phone number, 1 operation
get_whatsapp_phone_numbersGet whatsapp phone numbersGETReturns the default WhatsApp sender number of a list and every WhatsApp number available to it.
Workflow stats, 1 operation
get_workflow_statsGet workflow statsGETReturns daily automation stats for a list (sends, opens, clicks, purchases, revenue, bounces, unsubscribes), optionally for some workflows only. Choose the period with start_date and stop_date, days, or month.
Showing the first 120 of 151 endpoints. The rest are in the product, searchable from the workflow builder and from chat.
Use NewsMAN from Claude Code, Cursor or Codex
Connect NewsMAN in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its NewsMAN 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 NewsMAN
- Create your workspace
Sign up free. Nothing to install.
- Connect NewsMAN once
Add your NewsMAN 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.
NewsMAN integration FAQ
What can you do with the NewsMAN integration?
LiveContext exposes 151 operations on NewsMAN, covering newsletter, sms campaign, subscriber and segment.
