For Agents
Manage email lists, subscribers, templates, segments, senders, and campaigns in Blastable. Useful for agents that automate email marketing operations.
Get started with Blastable API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"add a new subscriber to a Blastable list"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Blastable API API.
Create, list, and delete email marketing lists in Blastable
Add subscribers individually or in bulk and unsubscribe them across one or all lists
Look up a subscriber by email or by custom field across the account
Manage email templates and segments used by campaigns
GET STARTED
Use for: Add a new subscriber to a Blastable list, Bulk import subscribers into Blastable from a CSV, Unsubscribe an email address from every Blastable list, Look up a subscriber by email across all lists
Not supported: Does not handle SMS, push notifications, or transactional billing — use for email marketing list, subscriber, template, segment, sender, and campaign management only.
The Blastable API is the programmatic surface of Blastable, an email marketing platform focused on inbox deliverability. It exposes the full set of email-marketing primitives: lists, subscribers (including bulk create and cross-list search), templates, segments, senders, sending domains, and campaigns. Marketers use it to keep subscriber lists in sync with their CRM, manage transactional and broadcast templates, and orchestrate campaigns programmatically without the Blastable web UI.
Configure senders, including resending the confirmation email and updating sender details
Drive Blastable campaigns from external workflows without using the web UI
Patterns agents use Blastable API API for, with concrete tasks.
★ CRM-to-Blastable Subscriber Sync
Keep Blastable subscriber lists in sync with the CRM as contacts are created, updated, or marked as opted out. POST /lists/{list_uid}/subscribers/bulk handles the initial import, PUT /lists/{list_uid}/subscribers/{subscriber_uid} handles updates, and PUT /lists/subscribers/unsubscribe-by-email-from-all-lists removes a contact from every list when they revoke consent. This keeps marketing reach aligned with the source of truth.
POST /lists/{list_uid}/subscribers/bulk with a batch of new contacts, then PUT /lists/{list_uid}/subscribers/{subscriber_uid} for each contact whose record changed since the last sync.
Cross-List Unsubscribe Compliance
When a contact requests removal under data protection rules, the workflow must remove them from every Blastable list, not just one. PUT /lists/subscribers/unsubscribe-by-email-from-all-lists handles that single-call cross-list unsubscribe and GET /lists/subscribers/search-by-email-in-all-lists confirms the change. The audit log records the email and timestamp for compliance evidence.
Call PUT /lists/subscribers/unsubscribe-by-email-from-all-lists for the supplied email, then GET /lists/subscribers/search-by-email-in-all-lists to confirm zero remaining subscriptions.
Template and Sender Configuration Audit
Periodically audit the templates and senders on the Blastable account to make sure brand and compliance details are current. GET /templates lists every template, GET /senders lists configured senders, and PATCH /senders/{sender_uid} updates display names or footer details. POST /senders/{sender_uid}/resend-confirmation re-triggers verification when DNS or address changes.
Call GET /senders, flag any sender whose status is not verified, and call POST /senders/{sender_uid}/resend-confirmation to re-trigger verification.
Segment-Targeted Campaign Reporting
Pull the subscribers in a Blastable segment to size or QA a planned campaign before it sends. GET /segments lists segments, GET /segments/{segment_uid}/subscribers enumerates the audience, and the result feeds an internal QA step that confirms the audience size meets the campaign brief. The flow runs entirely server-side without exporting CSVs.
Call GET /segments, then GET /segments/{segment_uid}/subscribers for the chosen segment, and report the audience size to the campaign QA channel.
Agent-Driven Subscriber Add via Jentic
An AI agent capturing leads from a chat interface adds each new lead to the right Blastable list. It searches Jentic for 'add a new subscriber to a Blastable list', loads the POST /lists/{list_uid}/subscribers schema, and executes the call with the list id and subscriber email. The Blastable API key never leaves Jentic's vault, which is critical because the same key controls subscriber writes across the account.
Use Jentic search for 'add a new subscriber to a Blastable list', load the schema, then execute POST /lists/{list_uid}/subscribers with the email and required fields.
40 endpoints — the blastable api is the programmatic surface of blastable, an email marketing platform focused on inbox deliverability.
METHOD
PATH
DESCRIPTION
/lists
List email lists
/lists/{list_uid}/subscribers
Create a subscriber on a list
/lists/{list_uid}/subscribers/bulk
Bulk create subscribers
/lists/subscribers/unsubscribe-by-email-from-all-lists
Unsubscribe an email from every list
/lists/subscribers/search-by-email-in-all-lists
Find a subscriber by email across all lists
/templates
List email templates
/segments/{segment_uid}/subscribers
List subscribers in a segment
/senders
List configured senders
/lists
List email lists
/lists/{list_uid}/subscribers
Create a subscriber on a list
/lists/{list_uid}/subscribers/bulk
Bulk create subscribers
/lists/subscribers/unsubscribe-by-email-from-all-lists
Unsubscribe an email from every list
/lists/subscribers/search-by-email-in-all-lists
Find a subscriber by email across all lists
Three things that make agents converge on Jentic-routed access.
Credential isolation
Blastable uses an X-API-KEY header. Jentic stores the key in the encrypted vault and exposes only a scoped Jentic token to the agent — important because Blastable does not offer per-list scoping, so the raw key would otherwise expose the entire subscriber base.
Intent-based discovery
Agents search Jentic with intents like 'add a new subscriber to a Blastable list' or 'unsubscribe an email from every Blastable list' and Jentic returns the matching operation from the 40-endpoint spec with its input schema.
Time to first call
Direct integration: 1-2 days to wire the X-API-KEY header, list/subscriber CRUD, and bulk import error handling. Through Jentic: under 2 hours — search the operation, load schema, execute against /lists or /subscribers.
Alternatives and complements available in the Jentic catalogue.
Bland AI API
Bland AI handles voice and SMS while Blastable handles email — useful as a multi-channel outreach pair.
Use Blastable for the email leg of a campaign and Bland AI for the voice/SMS leg.
BizToc
BizToc supplies business news content that a Blastable newsletter can syndicate.
Pair them when an automated newsletter needs fresh business content as the daily payload.
Blackfire API
Blackfire profiles the application that drives Blastable to keep subscriber-sync jobs responsive.
Use Blackfire when a Blastable sync service needs latency or memory profiling.
Specific to using Blastable API API through Jentic.
What authentication does the Blastable API use?
API key authentication via the X-API-KEY header (security scheme apiKey). Through Jentic the key is stored in the encrypted vault and the agent receives a scoped Jentic token instead of the raw key — important because the same key authorises subscriber writes across every list on the account.
Can I bulk import subscribers with the Blastable API?
Yes. POST /lists/{list_uid}/subscribers/bulk accepts a batch of subscriber records for the specified list, which is the right entry point for CRM exports or one-off imports. Use POST /lists/{list_uid}/subscribers for single inserts.
How do I unsubscribe an email from every Blastable list at once?
Call PUT /lists/subscribers/unsubscribe-by-email-from-all-lists with the email. This single call removes the contact from every list on the account, which is the pattern needed for compliance with data-protection unsubscribe requests.
What are the rate limits for the Blastable API?
The OpenAPI spec does not declare an explicit rate limit. Treat the API as paced for marketing operations rather than high-fan-out reads, and back off on HTTP 429 responses if a bulk import or audit script triggers throttling.
How do I add a Blastable subscriber through Jentic?
Install with pip install jentic, then use Jentic search with 'add a new subscriber to a Blastable list'. Jentic loads the POST /lists/{list_uid}/subscribers schema and executes it with the list id and subscriber details. The X-API-KEY header value never enters the agent's prompt.
Can I look up a subscriber by email across all lists?
Yes. GET /lists/subscribers/search-by-email-in-all-lists performs the cross-list search and returns each list the email is subscribed to. This is the right call for compliance lookups, customer-support investigations, or pre-import dedupe.
/templates
List email templates
/segments/{segment_uid}/subscribers
List subscribers in a segment
/senders
List configured senders