Getmateo Mateo API

Name: Mateo API
Brand: Mateo API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCRMContact Managementbearer32 EndpointsREST

For Agents

Manage Mateo appointments, deals, messages, segments, and contact custom fields through a Bearer-authenticated CRM-style API.

Install Jentic One Beta

Connect the Mateo API to your agent

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

Create, list, update, and delete appointments through the /appointment endpoints

Manage sales deals with create, list, update, and delete operations on /deal

List and delete messages, and read message channels through /message and /channel

GET STARTED

Start building with Mateo API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for the Mateo API, keeping it validated and agent-ready. Mateo is a GDPR-compliant customer communications platform combining CRM, messaging, and appointment management. The integration v1 REST API exposes 32 endpoints covering appointments, deals, messages, channels, tags, segments, custom fields, deal types, appointment statuses, events, and contact custom field values. Authentication is HTTP Bearer using a per-account integration token. Designed for embedding Mateo inside booking, CRM, and marketing workflows.

Use Cases

Patterns agents use Mateo API for, with concrete tasks.

★ Booking-System Appointment Sync

Mirror appointments created in an external booking system into Mateo so that customer-facing messaging stays in sync. The integration calls POST /appointment to create, PATCH /appointment to update, and DELETE /appointment for cancellations. Avoids duplicate-entry overhead for businesses that already run a booking calendar.

Call POST /appointment with contactId, datetime, and status, then PATCH the same endpoint when the customer reschedules.

Sales Pipeline Reporting

Pull deal data into a downstream BI tool by listing deals, deal types, and tagging metadata. The integration calls GET /deal, GET /deal_type, and GET /tag. Useful for managers who want a single deal view across Mateo and other CRMs.

Call GET /deal and GET /deal_type, join the responses on dealTypeId, and return a pipeline summary by stage.

Custom Field Hydration

Hydrate Mateo contacts with structured data from external systems using contact custom fields. The integration calls POST /contact_custom_field to set values and PATCH or DELETE to maintain them over time. Ideal for integrating account-specific attributes like tier, region, or churn risk.

Call POST /contact_custom_field with contactId, customFieldId, and value, then PATCH later to refresh the value when the source data changes.

AI Agent CRM Concierge

An AI agent acts as a Mateo CRM concierge that creates appointments, updates deals, and writes contact custom fields based on conversation context. The agent uses Jentic's intent search to discover the right operation rather than reading docs, and Jentic isolates the Bearer integration token. Time-to-first-update drops from hours to minutes.

Search Jentic for 'create a Mateo appointment', load the schema for POST /appointment, and create an appointment for the contact mentioned in the latest agent conversation.

Key Endpoints

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

METHOD

PATH

DESCRIPTION

POST

/appointment

Create an appointment

PATCH

/appointment

Update an appointment

POST

/deal

Create a deal

PATCH

/deal

Update a deal

POST

/contact_custom_field

Set a contact custom field value

GET

/segment

List segments

POST

/appointment

Create an appointment

PATCH

/appointment

Update an appointment

POST

/deal

Create a deal

PATCH

/deal

Update a deal

POST

/contact_custom_field

Set a contact custom field value

GET

/segment

Why Jentic?

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

Credential isolation

Mateo Bearer integration tokens are stored encrypted in the Jentic vault. Jentic injects the Authorization header on each call so the integration token stays out of the agent context and out of logs.

Intent-based discovery

Agents search Jentic with intents like 'create a Mateo appointment' or 'update a Mateo deal' and Jentic returns the matching operation with its full input schema, including required path-free body fields.

Time to first call

Direct Mateo integration: 1-2 days to wire up Bearer auth, custom field discovery, and the appointment lifecycle. Through Jentic: under 1 hour using search, load, execute.

FAQs

Specific to using Mateo API through Jentic.

Why is there no official OpenAPI spec for the Mateo API?

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

Mateo uses HTTP Bearer authentication with an integration token issued per Mateo workspace. Jentic stores the integration token in its encrypted vault and injects the Authorization header at execution time so the token never enters the agent context.

Can I create an appointment with the Mateo API?

Yes. Call POST /appointment with contactId, datetime, and the relevant appointment status id from GET /appointment_status. The endpoint returns the created appointment's id which you can use for later PATCH or DELETE calls.

What are the rate limits for the Mateo API?

Mateo does not encode rate limits in the spec. Plan for sustained throughput around 5 requests per second per integration token and back off when 429 responses appear; treat the integration endpoints as control-plane traffic rather than high-volume eventing.

How do I update a Mateo deal through Jentic?

Search Jentic for 'update a Mateo deal', load the schema for PATCH /deal, and execute with the dealId and the fields to change. Jentic injects the Bearer token automatically and surfaces the updated record in the response.

Does the Mateo API support custom fields on contacts?

Yes. POST /contact_custom_field sets a value, PATCH updates it, DELETE removes it, and GET /contact_custom_field returns the values currently attached to a contact. Combine with GET /custom_field to discover which custom field definitions exist.

Getmateo Mateo API

Connect the Mateo API to your agent

Capabilities

Start building with Mateo API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs