For Agents
Sync e-commerce contacts, products, orders, and carts into Omnisend and track custom events that trigger email and SMS automations.
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://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 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
GET STARTED
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.
Update cart records to drive abandoned-cart automation
Sync product catalogue records used in email content blocks
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
Three things that make agents converge on Jentic-routed access.
Credential isolation
Omnisend uses bearer-token auth. Jentic stores the token encrypted in the MAXsystem vault and injects it on each call. Agents reference a credential handle and never see the raw token.
Intent-based discovery
Agents search Jentic for 'create omnisend contact' or 'track omnisend event' and Jentic returns the right operation (POST /contacts or POST /events) with its input schema typed.
Time to first call
Direct integration: 1-2 days to model contacts, events, orders, and carts and handle 429 retries. Through Jentic: under an hour — search, load, execute.
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 at https://app.jentic.com/sign-up.
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.
List campaigns