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://jentic.com/install.sh?src=apis&api=%2Fapis%2Finboxroute.com%2Fmailsquad" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Finboxroute.com%2Fmailsquad" | 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
Remove contacts that should no longer receive mail
GET STARTED
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
/subscription/{listid}
Subscribe a contact to a list
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the MailSquad API by hand means passing your key in the Authorization header on every call and mapping its contact and list endpoints yourself. Through Jentic you install once, import MailSquad from the API Directory, store the API key once, and your agent calls it.
Permission scoping
MailSquad puts the list id in the URL path (/subscription/{listid}) and the contact id in /contacts/{contactid}, so a rule can pin your agent to subscribing contacts to one list. You choose the operations it may call, so deleting contacts is not included unless you add it.
Credential isolation
Your MailSquad API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
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 calls the right endpoint without browsing the reference docs.
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.
Can I limit what my agent is allowed to do with the MailSquad API?
Yes. Because you run Jentic One yourself, you decide which MailSquad operations the agent may call, and your own rules are enforced at execution time. MailSquad carries the list id in the path at POST /subscription/{listid} and the contact id at /contacts/{contactid}, so you can pin the agent to subscribing contacts to a single list while excluding PUT /contacts/{contactid} and DELETE /contacts/{contactid}. Deleting or updating contacts is available only if you explicitly grant it, and the stored API key is injected at runtime rather than exposed to the agent.
Know of an official OpenAPI document? Contribute it →
For Agents
Manage MailSquad contacts, lists, and subscriptions. Useful for syncing contact data and powering subscribe and unsubscribe flows.
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.