Contlo API

Name: Contlo API API
Brand: Contlo API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMarketingMarketing AutomationapiKey5 EndpointsREST

For Agents

Identify customer profiles and track behavioural events into Contlo for AI-driven marketing, plus read subscribers and customers via the Zapier-integration endpoints.

Quickstart

Get started with Contlo 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:
"track a contlo event"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Contlo API API.

Identify a customer profile by sending traits to /v1/identify

Track a behavioural event for a customer with /v1/track

Authenticate the Zapier integration on behalf of a workspace via /api/integrations/zapier

Read the list of subscribers exposed to the Zapier integration

Read the list of customers exposed to the Zapier integration

GET STARTED

Start building with Contlo API API

Explore with Jentic

View OpenAPI Document

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

Jentic publishes the only available OpenAPI specification for Contlo API, keeping it validated and agent-ready. The Contlo marketing API ingests customer profile updates and behavioural events for AI-driven marketing campaigns, and exposes integration endpoints used by the Contlo Zapier connector to read subscribers and customers. Authentication uses an X-API-KEY header issued from the Contlo workspace.

Use Cases

Patterns agents use Contlo API API for, with concrete tasks.

★ Behavioural Event Capture

Direct-to-consumer brands use POST /v1/track to capture behavioural events such as product views, add-to-cart, and purchases, which Contlo then uses to power AI-segmented marketing campaigns. Events carry a user identifier and an event payload, so downstream Contlo flows can react in near real time. Integration takes hours rather than days because the track endpoint accepts simple JSON.

POST /v1/track with user_id, event='order_placed', and properties including order_id and total_amount, then verify the event arrives in Contlo's event stream

Customer Profile Sync

POST /v1/identify pushes a known customer's traits — name, email, location, lifecycle stage — into Contlo so that segments and AI-personalised campaigns target the right person. Identify calls upsert profiles, so syncing from a CRM or e-commerce backend is idempotent. Combined with track, identify gives Contlo a unified view of who the user is and what they did.

POST /v1/identify with user_id, email, traits including first_name and lifecycle_stage='active' for each row in a daily customer export

Zapier-Backed Data Export

When a Contlo customer needs to export subscribers or customers without writing a backend integration, GET /api/integrations/zapier/subscribers and GET /api/integrations/zapier/customers expose the data the Zapier connector consumes. These endpoints can also be called directly from a custom integration that wants to mirror the Zapier behaviour. The /api/integrations/zapier POST authenticates the workspace for the integration session.

POST /api/integrations/zapier to authenticate, then GET /api/integrations/zapier/subscribers paginated, and write each subscriber to a CSV

AI Agent Marketing Event Capture via Jentic

An AI agent embedded in an e-commerce backend calls Contlo's identify and track endpoints whenever a relevant business event occurs — order placed, abandonment, lifecycle-stage change. Through Jentic the X-API-KEY is held in MAXsystem so the agent never sees the raw key, and the agent reads the operation schema before sending the event. This avoids hard-coding the Contlo URL and key into agent prompts.

Search Jentic for 'track a contlo event', execute with user_id, event='cart_abandoned', and properties including cart_value=149.00 and currency='INR'

Key Endpoints

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

METHOD

PATH

DESCRIPTION

POST

/v1/identify

Identify or upsert a customer profile with traits

POST

/v1/track

Track a behavioural event for a known user

POST

/api/integrations/zapier

Authenticate the Zapier integration session

GET

/api/integrations/zapier/subscribers

List subscribers visible to the Zapier integration

GET

/api/integrations/zapier/customers

List customers visible to the Zapier integration

POST

/v1/identify

Identify or upsert a customer profile with traits

POST

/v1/track

Track a behavioural event for a known user

POST

/api/integrations/zapier

Authenticate the Zapier integration session

GET

/api/integrations/zapier/subscribers

List subscribers visible to the Zapier integration

GET

/api/integrations/zapier/customers

List customers visible to the Zapier integration

Why though Jentic?

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

Credential isolation

Contlo X-API-KEYs are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access at call time and never see the raw key, so a single agent can serve multiple Contlo workspaces without leaking credentials between tenants.

Intent-based discovery

Agents search Jentic by intent (e.g. 'track a contlo event') and Jentic returns the matching identify, track, or Zapier-integration operation with its input schema, so the agent calls the right endpoint without browsing Contlo's docs.

Time to first call

Direct Contlo integration: half a day to wire the X-API-KEY, model the identify and track payloads, and handle the Zapier-integration authentication step. Through Jentic: under 30 minutes to search, load schema, and execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Klaviyo API

Klaviyo provides a deeper marketing automation suite with built-in flows, segments, and SMS in one API.

Choose Klaviyo for established e-commerce operations on Shopify; choose Contlo when AI-driven journey generation and an Indian-market focus are priorities.

Alternative

Mailchimp Marketing API

Mailchimp covers email, automations, and audience management at scale.

Choose Mailchimp when the team already runs newsletters and journeys there; choose Contlo for AI-personalisation-first workflows.

Complementary

SendGrid Email Activity API

SendGrid handles transactional email delivery while Contlo runs the marketing campaigns.

Use SendGrid for receipts and password resets and Contlo for AI-curated marketing campaigns to the same audience.

FAQs

Specific to using Contlo API API through Jentic.

Why is there no official OpenAPI spec for Contlo API?

Contlo's documentation lives across help articles and a Zapier connector reference rather than a hosted OpenAPI 3 file. Jentic generates and maintains this spec so that AI agents and developers can call Contlo 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 Contlo API use?

Each request must include an X-API-KEY header issued from the Contlo workspace. Through Jentic the API key is stored in the MAXsystem vault and applied at call time, so the agent never holds the raw value.

Can I track customer events with the Contlo API?

Yes. POST /v1/track with a user_id, event name, and properties payload records a behavioural event tied to that user. Combine with POST /v1/identify to make sure the user profile and traits are up to date before the event is recorded.

What are the rate limits for the Contlo API?

Contlo applies per-workspace rate limits sized to the customer's plan; current quotas and usage are visible in the Contlo dashboard. Through Jentic, retries with exponential backoff are handled at the SDK level so transient throttling does not surface to agent code.

How do I send an identify call with the Contlo API through Jentic?

Run `jentic.search('identify a contlo customer')`, load the operation, and execute with user_id, email, and any extra traits. Jentic resolves this to POST /v1/identify and upserts the profile in Contlo.

Does the Contlo API support exporting subscribers?

Yes. GET /api/integrations/zapier/subscribers returns the subscribers visible to the Zapier integration session, which can be paginated to export the full list. POST /api/integrations/zapier authenticates the integration session before the subscriber list call.