Ometria Data API

Name: Ometria Data API API
Brand: Ometria Data API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMarketingMarketing AutomationapiKey34 EndpointsREST

For Agents

Push customer, product, order, and event data into Ometria's marketing platform and pull back segments, profiles, and unsubscribes for downstream campaigns.

Connect the Ometria Data API to your agent

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

Install Jentic One Beta (Self-Hosted)

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

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 Ometria Data API API.

Push customer, product, order, and custom event records via the bulk /push endpoint

Inspect /push-errors to diagnose rejected records from the last bulk import

Retrieve products and orders by ID for downstream catalogue sync

Read contact collections and individual contacts by ID for personalisation

GET STARTED

Start building with Ometria Data API API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for Ometria Data API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for Ometria Data API, keeping it validated and agent-ready. The Ometria Data API is the integration layer for Ometria's customer data and marketing platform, enabling brands to push customer, product, order, and event records into Ometria and to retrieve segmented data for downstream use. It exposes 34 endpoints covering bulk push, products, orders, contact collections, custom events, profile management with a profile-merge job system, list (segment) export, transactional email send, and unsubscribes/data-deletion request lookup. Authentication uses the X-Ometria-Auth header.

Use Cases

Patterns agents use Ometria Data API API for, with concrete tasks.

★ Order and Customer Sync from E-Commerce

An e-commerce platform pipes new orders, customers, and product updates into Ometria using POST /push as the single ingestion endpoint, then polls GET /push-errors to surface rejected records back to the data team. This keeps the marketing platform in sync without bespoke per-resource endpoints.

POST a batch of 200 mixed records (customers, orders, products) to /push, then GET /push-errors to inspect any failures and re-push corrected records.

Segment Activation for Email Campaigns

Marketing teams build segments (lists) inside Ometria and use GET /lists/{list_id}/contacts/export to download segment membership for activation in adjacent channels (paid social audiences, direct mail). The export endpoint is built for scale and returns the full membership rather than a paginated trickle.

GET /lists to find the 'cart-abandoners' segment ID, then GET /lists/{list_id}/contacts/export to pull the full membership.

Profile Deduplication via Merge Jobs

When the same customer appears under two profiles (different emails, same person), POST /merge-profile schedules a merge job that consolidates them. GET /merge-profile lists running jobs and GET /merge-profile/{job_id} returns the status of a specific job. This is the recommended path over manual SQL fixups in the underlying data.

POST /merge-profile with two profile IDs, then poll GET /merge-profile/{job_id} until status is complete.

AI Agent Marketing Operations

An AI agent integrated through Jentic can ingest a CSV of new customers from a one-off campaign, push them via /push, monitor /push-errors, and then trigger a transactional welcome email — all without seeing the X-Ometria-Auth header. Jentic stores the credential and returns scoped operation handles only.

Search Jentic for 'push customers to ometria', load /push, ingest 500 records, then call /transactional-email/send to dispatch a welcome email to each.

Key Endpoints

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

METHOD

PATH

DESCRIPTION

POST

/push

Bulk-push records (customers, orders, products, events)

GET

/push-errors

List rejected records from recent pushes

GET

/lists/{list_id}/contacts/export

Export segment membership

POST

/merge-profile

Run a profile-merge job

POST

/transactional-email/send

Send a transactional email

GET

/unsubscribes

List unsubscribes for compliance

POST

/push

Bulk-push records (customers, orders, products, events)

GET

/push-errors

List rejected records from recent pushes

GET

/lists/{list_id}/contacts/export

Export segment membership

POST

/merge-profile

Run a profile-merge job

POST

/transactional-email/send

Send a transactional email

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Ometria uses an X-Ometria-Auth API-key header. Jentic stores this header value in the encrypted MAXsystem vault and injects it at execution. Agents reference the credential by handle and never see the raw key.

Intent-based discovery

Agents search Jentic with phrases like 'push customers to ometria' or 'export ometria segment' and Jentic returns the right operation (often /push or /lists/{list_id}/contacts/export) with its full schema.

Time to first call

Direct integration: 3-5 days for /push payload modelling, error retry handling, and merge-job polling. Through Jentic: under an hour — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Klaviyo API

Email and SMS marketing platform with deep e-commerce integrations.

Choose Klaviyo when the team prefers a US-based platform with native Shopify and SMS support — Ometria is more retail and UK/EU-centric.

Complementary

Shopify Admin API

Source store data that gets pushed into Ometria for personalisation.

Pair Shopify with Ometria when Shopify is the source of truth for orders and products and Ometria runs the marketing layer.

Complementary

Segment API

Customer data pipeline that fans events into Ometria and other tools.

Use Segment in front of Ometria when the same event stream needs to fan out to several downstream platforms.

FAQs

Specific to using Ometria Data API API through Jentic.

Why is there no official OpenAPI spec for Ometria Data API?

Ometria does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Ometria Data 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 Ometria Data API use?

Every request must include the X-Ometria-Auth header carrying an API key issued from the Ometria UI. Jentic stores this key encrypted in the MAXsystem vault and injects it on each call, so agents never see the raw header.

Can I send transactional emails through the Ometria Data API?

Yes. POST /transactional-email/send dispatches a one-off transactional email using a template configured in Ometria. This is separate from the campaign system and is intended for receipts, password resets, and order confirmations.

What are the rate limits for the Ometria Data API?

Rate limits are not declared in the OpenAPI spec but Ometria recommends pushing data in batches of up to 1,000 records per /push call. Use /push-errors to detect rejections rather than retrying full batches blindly.

How do I dedupe two customer profiles through Jentic?

Search Jentic for 'merge ometria profiles', load POST /merge-profile, and pass the two profile IDs. Then poll GET /merge-profile/{job_id} to confirm completion.

Is the Ometria Data API rate-limited per endpoint?

The spec does not differentiate per-endpoint limits. The /push endpoint is built for bulk ingestion (preferred for high-volume writes) while individual /products/{id} and /orders/{id} reads are intended for low-frequency lookups.