Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Omnisend 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%2Fomnisend.com%2Fomnisend" | 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%2Fomnisend.com%2Fomnisend" | 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 Omnisend API.
Create or update contacts with consent status, tags, and custom fields
Track custom events that fire Omnisend automation flows
Push order data into Omnisend to feed post-purchase and reorder flows
Update cart records to drive abandoned-cart automation
Sync product catalogue records used in email content blocks
GET STARTED
List and retrieve campaigns to monitor scheduled and sent campaigns
Read individual contacts by ID for personalisation lookups
Patterns agents use Omnisend API for, with concrete tasks.
★ E-Commerce Contact Sync
Stores sync new and returning customers into Omnisend via POST /contacts (which creates or updates by email/phone). The endpoint accepts consent status, tags, and custom fields, so a single call fully describes the subscriber state for downstream segmentation.
POST /contacts with email, consent=subscribed, and tags=['new-customer'] for every order placed in the last hour.
Cart Abandonment Automation
When a shopper adds items but doesn't check out, POST /carts records the cart state. Omnisend uses the cart events to trigger its abandoned-cart automation, which sends a recovery email or SMS after a configurable delay. Update the cart with a new POST when items change so the recovery message reflects the latest contents.
POST /carts with the contact's email, the cart ID, and an array of cart items so Omnisend's abandoned-cart flow can target the contact.
Custom Event Tracking
POST /events records arbitrary custom events (browse_product, completed_quiz, downloaded_guide) that can be referenced as triggers inside Omnisend's automation builder. This lets marketers build flows that fire on product behaviour beyond the built-in cart and order events.
POST /events with eventType='product_viewed', the contact email, and a properties object containing productId and productName.
AI Agent Marketing Operations
An AI agent integrated through Jentic can take a CSV of new sign-ups and a list of recent orders, and sync both into Omnisend in one go - calling POST /contacts and POST /orders behind the scenes. Jentic stores the bearer token encrypted, so the agent never sees the raw credential.
Search Jentic for 'create omnisend contact', load POST /contacts, and execute it for 250 sign-ups; then call POST /orders for each order placed today.
12 endpoints — jentic publishes the only available openapi specification for omnisend api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/contacts
Create or update a contact
/events
Track a custom event
/orders
Create an order record
/carts
Create or update a cart
/products
Create a product catalogue entry
/campaigns
List campaigns
/contacts
Create or update a contact
/events
Track a custom event
/orders
Create an order record
/carts
Create or update a cart
/products
Create a product catalogue entry
/campaigns
List campaigns
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Omnisend API by hand means managing its bearer token and building each contact, event, order, cart, and product call against api.omnisend.com/v5 yourself. Through Jentic you install once, import the Omnisend API from the API Directory, store the token once, and your agent calls it.
Permission scoping
Omnisend takes its contact, event, order, and product data in the request body rather than the URL path, so you limit the agent to the operations it needs, such as creating a contact or tracking an event. Reading campaigns or writing orders are excluded unless you add those operations to the allowed set.
Credential isolation
Your Omnisend token 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 'create an omnisend contact' or 'track an omnisend event', and Jentic returns the matching Omnisend operation (POST /contacts or POST /events) 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 Omnisend API through Jentic.
Why is there no official OpenAPI spec for Omnisend API?
Omnisend does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Omnisend API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the Omnisend API use?
Omnisend uses bearer tokens (Authorization: Bearer ...) generated from the Omnisend store settings. Jentic stores this token encrypted in its vault and attaches it to each request, so agents reference only a credential handle.
Can I trigger Omnisend's abandoned-cart automation through the API?
Yes. POST /carts with the contact email, cart ID, and item array creates or updates the cart record. Omnisend's abandoned-cart flow uses these cart updates as triggers, so timely POSTs drive the automation.
What are the rate limits for the Omnisend API?
Omnisend applies a per-second request limit at the v5 API level (typically around 400 requests per minute per store). Watch for HTTP 429 responses and back off; batch contact sync into POST /contacts calls rather than parallel-spamming.
How do I track a custom event for an automation flow through Jentic?
Search Jentic for 'track omnisend custom event', and the SDK returns POST /events. Provide the contact identifier and the eventType plus a properties object - Omnisend's automation builder can reference this event as a trigger.
Does the Omnisend API send transactional emails directly?
The v5 API exposes campaigns, contacts, events, and e-commerce data - it does not include a direct transactional-send endpoint. Transactional emails are configured as automation flows inside Omnisend, triggered by events you POST to /events.
Can I limit what my agent is allowed to do with the Omnisend API?
Yes. Jentic One is self-hosted, so you run your own instance and your own rules decide which Omnisend operations and credentials the agent may use. You can allow just the calls a task needs, such as creating a contact with POST /contacts or tracking an event with POST /events, while excluding writing orders with POST /orders or listing campaigns with GET /campaigns. Because Omnisend takes its contact, event, order, and product data in the request body rather than the URL path, the allowed operation set is what bounds the agent's access.
Know of an official OpenAPI document? Contribute it →
For Agents
Sync e-commerce contacts, products, orders, and carts into Omnisend and track custom events that trigger email and SMS automations.
Use for: I need to add a new subscriber to our Omnisend list, Track a 'product_viewed' event for a specific contact, Push today's orders from our shop into Omnisend, Update a cart to trigger Omnisend's abandoned-cart flow
Not supported: Does not handle template editing, automation-flow design, or paid-media buying - use for contact, event, order, cart, and product data sync only.
Jentic publishes the only available OpenAPI specification for Omnisend API, keeping it validated and agent-ready. The Omnisend v5 API is the integration layer for Omnisend's email and SMS marketing platform aimed at e-commerce brands. It exposes 12 endpoints covering contact management, custom event tracking, campaign listing, product catalogue sync, order ingestion, and cart updates - the data signals Omnisend uses to build automations like cart abandonment and post-purchase flows. Authentication uses bearer tokens issued from the Omnisend store settings.