For Agents
Manage Agillic recipients, segment audiences with target groups, fire personalisation events, execute flows, and run async data exports across email, SMS, and app push channels.
Get started with Agillic 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 recipient to an Agillic target group"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Agillic API API.
Create, update, and delete recipients individually or via async batch upsert and delete jobs
Read and write one-to-many tables tied to a recipient for purchase history or preferences
Achieve events on a recipient with optional context payloads to trigger flows
Execute flows directly to launch campaigns on demand
GET STARTED
Use for: Create a new recipient with email and consent fields, Update the marketing consent flag for recipient ID 4421, I want to upsert 50000 recipients in a single async batch, Achieve the 'cart_abandoned' event on a recipient with cart total context
Not supported: Does not handle email rendering, deliverability monitoring, or web personalisation widgets — use for recipient, segment, event, and flow orchestration only.
Jentic publishes the only available OpenAPI specification for Agillic API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Agillic API, keeping it validated and agent-ready. Agillic is a customer marketing automation platform for managing recipients, segmenting audiences, and orchestrating cross-channel campaigns through flows. The API exposes 81 endpoints covering recipient CRUD, batch upserts, one-to-many tables, event achievement, target group membership, flow execution, app push device registration, asset management, and asynchronous data exports. Authentication supports OAuth2 bearer tokens (preferred) and HTTP basic for legacy clients.
Add and remove recipients from static target groups for campaign segmentation
Register, unregister, and manage app push consent for device identifiers
Schedule and download async data exports of recipients, events, and statistics
Patterns agents use Agillic API API for, with concrete tasks.
★ Recipient and Consent Management
Operations teams keep Agillic recipient records in sync with a primary CRM by creating, updating, and deleting profiles through the recipient endpoints. The async batch upsert at /recipients/v2/:upsert handles tens of thousands of records per call, returning a job handle to poll. Consent fields and one-to-many tables can be updated in the same flow, keeping marketing eligibility accurate ahead of each send.
POST /recipients/v2/:upsert with a 10000-row batch, then poll the returned job until status is completed
Event-Driven Personalisation
Agillic flows fire when recipients achieve events such as 'order_placed' or 'cart_abandoned'. The API accepts events with structured context, so an agent can drop in product IDs, totals, or recommendation slots and the downstream flow will fan out the personalised email, SMS, or push. /recipients/{id}/events/{eventId}/:achieveWithContext is the canonical write path.
POST /recipients/{id}/events/cart_abandoned/:achieveWithContext with cart_total and product_ids
Audience Segmentation via Target Groups
Marketers assemble static target groups in Agillic and use the API to add or remove recipients from those groups based on external rules — recent purchases, support history, or model scores. /recipients/:addToStaticTargetGroup and :removeFromStaticTargetGroup move recipients in bulk so a daily segmentation job can keep groups current without UI work.
POST /recipients/:addToStaticTargetGroup with 200 recipient IDs and target group 'reactivation_q3'
Flow Execution On Demand
Beyond event triggers, agents can launch a flow directly via /flows/{flowName}/:execute, useful for transactional sends like password reset or order confirmation that must run immediately rather than wait for a scheduled segment. Combined with recipient lookup, an agent can pick a recipient and fire a named flow in two calls.
POST /flows/password_reset/:execute with the recipient ID and a one-time token
AI Agent Marketing Operations via Jentic
An agent built on Jentic can sit between a CRM and Agillic, translating natural-language requests like 'add these 30 customers to the loyalty programme reactivation list' into the right combination of recipient lookup, target group write, and event achievement calls. Jentic stores the bearer token in its vault and injects it per request, so the credential never appears in agent memory.
Use Jentic to search 'add a recipient to a target group', execute the call for 30 IDs, and confirm membership
81 endpoints — jentic publishes the only available openapi specification for agillic api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/oauth2/token
Obtain an OAuth2 bearer token
/recipients
Create a recipient
/recipients/v2/:upsert
Async batch upsert recipients
/recipients/{recipientId}/events/{eventId}/:achieveWithContext
Achieve an event with context
/recipients/:addToStaticTargetGroup
Add recipients to a static target group
/recipients/:removeFromStaticTargetGroup
Remove recipients from a static target group
/recipients/{recipientId}/targetGroups
List a recipient's target groups
/recipients/{recipientId}/promotions/{promotionId}/:evaluatePromotion
Evaluate a promotion for a recipient
/oauth2/token
Obtain an OAuth2 bearer token
/recipients
Create a recipient
/recipients/v2/:upsert
Async batch upsert recipients
/recipients/{recipientId}/events/{eventId}/:achieveWithContext
Achieve an event with context
/recipients/:addToStaticTargetGroup
Add recipients to a static target group
Three things that make agents converge on Jentic-routed access.
Credential isolation
Agillic OAuth2 client credentials live in Jentic's vault. Token acquisition and refresh are handled outside the agent context, so neither the client secret nor the bearer token enters agent memory.
Intent-based discovery
Agents search by intent (e.g. 'add a recipient to a target group') and Jentic returns the matching Agillic operation with its input schema, including the static target group and recipient ID arrays.
Time to first call
Direct integration: 3-5 days to wire OAuth2, async job polling, and error retries. Through Jentic: under an hour — search, load schema, execute, with token refresh handled automatically.
Alternatives and complements available in the Jentic catalogue.
Agillic API (agillic.net)
Same Agillic platform exposed under the agillic.net domain with a smaller, bearer-only endpoint set
Use the agillic.net variant when only the smaller subset of endpoints is needed and OAuth2 setup is unavailable.
Klaviyo
Marketing automation platform for ecommerce with profiles, lists, segments, and flows
Choose Klaviyo for ecommerce-first marketing automation with deep Shopify and BigCommerce ties.
Braze
Cross-channel customer engagement platform with users, campaigns, and Canvas flows
Choose Braze for mobile-heavy multi-channel engagement at enterprise scale.
Customer.io
Behavioural messaging platform with people, segments, and triggered campaigns
Choose Customer.io for event-driven messaging with simpler workflow modelling.
HubSpot
CRM platform that often supplies the contact and deal data feeding Agillic recipients
Pair HubSpot with Agillic to source profile and consent data, then upsert into Agillic for sending.
Specific to using Agillic API API through Jentic.
Why is there no official OpenAPI spec for Agillic API?
Agillic does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call the Agillic API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Agillic API use?
Two schemes are supported: an OAuth2-style bearer token obtained via POST /oauth2/token, and HTTP basic for legacy access. Bearer is recommended; through Jentic the token is fetched, refreshed, and injected automatically without exposing the secret to the agent.
How do I add a recipient to a target group with the Agillic API?
Use POST /recipients/:addToStaticTargetGroup with the target group identifier and a list of recipient IDs. The endpoint accepts batches, so a single call can move many recipients into a segment in one request.
Can I upsert recipients in bulk through the Agillic API?
Yes. POST /recipients/v2/:upsert is async and accepts large batches; it returns a job handle that you poll until completion. For deletes, use the matching POST /recipients/v2/:delete async endpoint rather than per-recipient DELETE calls.
How do I execute a flow through Jentic?
Search Jentic for 'execute an Agillic flow', load the POST /flows/{flowName}/:execute schema, and call it with the flow name and the recipient context. Jentic injects the bearer token, so the agent only deals with the operational payload.
What are the rate limits for the Agillic API?
The OpenAPI spec does not encode explicit per-second limits. For high-volume workloads, prefer the v2 async batch endpoints (/recipients/v2/:upsert, /recipients/v2/:delete, /recipients/v2/events/:achieve) over per-record calls.
/recipients/:removeFromStaticTargetGroup
Remove recipients from a static target group
/recipients/{recipientId}/targetGroups
List a recipient's target groups
/recipients/{recipientId}/promotions/{promotionId}/:evaluatePromotion
Evaluate a promotion for a recipient