Agillic API

Name: Agillic API
Brand: Agillic API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMarketingMarketing Automationbearer, basic81 EndpointsREST

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.

Install Jentic One Beta

Connect the Agillic API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Agillic 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 | sh

Step 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 instance

Jentic 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.

Capabilities

What an agent can do with Agillic 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

GET STARTED

Start building with Agillic API

Explore with Jentic

View OpenAPI Document

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.

Use Cases

Patterns agents use Agillic 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

Key Endpoints

81 endpoints — jentic publishes the only available openapi specification for agillic api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/oauth2/token

Obtain an OAuth2 bearer token

POST

/recipients

Create a recipient

POST

/recipients/v2/:upsert

Async batch upsert recipients

POST

/recipients/{recipientId}/events/{eventId}/:achieveWithContext

Achieve an event with context

POST

/recipients/:addToStaticTargetGroup

Add recipients to a static target group

POST

/recipients/:removeFromStaticTargetGroup

Remove recipients from a static target group

GET

/recipients/{recipientId}/targetGroups

List a recipient's target groups

POST

/recipients/{recipientId}/promotions/{promotionId}/:evaluatePromotion

Evaluate a promotion for a recipient

POST

/oauth2/token

Obtain an OAuth2 bearer token

POST

/recipients

Create a recipient

POST

/recipients/v2/:upsert

Async batch upsert recipients

POST

/recipients/{recipientId}/events/{eventId}/:achieveWithContext

Achieve an event with context

POST

/recipients/:addToStaticTargetGroup

Add recipients to a static target group

Why Jentic?

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.

FAQs

Specific to using Agillic 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.

Agillic API

Connect the Agillic API to your agent

Capabilities

Start building with Agillic API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs