For Agents
Manage MailSquad contacts, lists, and subscriptions. Useful for syncing contact data and powering subscribe and unsubscribe flows.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the MailSquad API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with MailSquad API.
List contacts in the account
Manage contact lists used for segmenting recipients
Subscribe a contact to a specific list
Update contact details by id
GET STARTED
Use for: I want to subscribe a contact to a mailing list, List all contact lists in the account, Create a new contact list, Update contact details for a known contact id
Not supported: Does not send SMS, voice, or push notifications, and does not deliver transactional email - use for marketing contact and list management plus subscriptions only.
MailSquad is an email marketing platform for designing, sending, and tracking campaigns. The API exposes 8 endpoints covering contacts, contact lists, list subscriptions, and contact maintenance. Authentication uses an Authorization header containing the MailSquad API key. The API is best suited for syncing contact data from CRMs and websites, managing list membership, and driving subscription flows from agents and automations.
Remove contacts that should no longer receive mail
Power form-driven subscribe flows from a website or agent
Patterns agents use MailSquad API for, with concrete tasks.
★ Website Signup to List
Power a website newsletter signup by calling POST /subscription/{listid} with the form input. The API adds the contact to MailSquad and to the chosen list in one call, which is the right pattern for landing pages and lead magnets.
Subscribe email priya@example.com to list id 1234 from a website signup form.
List Lifecycle Management
Marketing operators can create, rename, and delete contact lists through the lists endpoints. The contact list resources support clean segmentation for campaigns without leaving the API surface for the dashboard.
Create a new list called 'Q3-Webinar-Attendees' and return the new list id.
Contact Sync from CRM
Sync contact records from a CRM to MailSquad by listing existing contacts, calling PUT /contacts/{contactid} to update changes, and DELETE for hard-deletes. The flow keeps the marketing audience aligned with the source-of-truth in the CRM.
Update contact id c-9876 to set their first name to 'Alex' and remove contact id c-1234 from MailSquad entirely.
Jentic Subscriber Agent
Through Jentic, an agent can manage MailSquad subscriptions from a chat surface. The agent searches by intent, loads the schema, and executes the right MailSquad endpoint without needing to remember the path or auth header format.
Search Jentic for 'subscribe a contact to a list', load the schema, and subscribe alex@example.com to list 5678.
8 endpoints — mailsquad is an email marketing platform for designing, sending, and tracking campaigns.
METHOD
PATH
DESCRIPTION
/contacts
List contacts
/contacts/lists
List contact lists
/contacts/lists
Create a contact list
/contacts/{contactid}
Update a contact
/contacts/{contactid}
Delete a contact
/subscription/{listid}
Subscribe a contact to a list
/contacts
List contacts
/contacts/lists
List contact lists
/contacts/lists
Create a contact list
/contacts/{contactid}
Update a contact
/contacts/{contactid}
Delete a contact
Three things that make agents converge on Jentic-routed access.
Credential isolation
MailSquad API keys are stored encrypted in the Jentic vault. Agents call the API with a scoped Jentic token; the raw Authorization header value never enters agent prompts or logs.
Intent-based discovery
Agents search Jentic by intent such as 'subscribe a contact to a list' and Jentic returns the matching MailSquad operation with its input schema, so the agent does not need to memorise the endpoint paths.
Time to first call
Direct MailSquad integration: half a day for auth, list CRUD, and subscribe flow. Through Jentic: under 30 minutes. Search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using MailSquad API through Jentic.
What authentication does the MailSquad API use?
MailSquad uses an Authorization header containing the API key issued from the MailSquad dashboard. Through Jentic, the key is stored in the encrypted vault and injected at runtime, so the raw key never enters the agent prompt or logs.
Can I subscribe a contact to a specific list?
Yes. POST /subscription/{listid} with the contact email and any custom fields adds the contact to MailSquad and to the specified list in one call, which is the recommended pattern for newsletter signups.
What are the rate limits for the MailSquad API?
The published spec does not declare hard rate limits. MailSquad enforces per-account fair-use limits, so bulk imports and sweeps should be paced and the response checked for 429 before retrying.
How do I add a contact to a list through Jentic?
Search Jentic for 'subscribe a contact to a list' to find the operation backed by POST /subscription/{listid}. Load the schema, pass the list id and contact email, and execute. Jentic injects the Authorization header at runtime.
Can I delete a contact via the MailSquad API?
Yes. DELETE /contacts/{contactid} removes the contact from MailSquad. Use this for hard-delete flows when a CRM record is removed or a user invokes a right-to-erasure request.
/subscription/{listid}
Subscribe a contact to a list