🖥️API

Get your API credentials, connect AI assistants like Claude and ChatGPT, and find the full developer documentation for the Gleantap API.

Gleantap has a REST API for building integrations with your account. Use it to read contacts, events, and campaign results, or to push in contacts, events, and messages. It also powers AI assistants like Claude and ChatGPT through the Gleantap MCP server.

The full developer documentation is at developers.gleantap.com. This page covers what most people need: where to find your credentials and where to go next.

Build an integration

v3 API reference: authentication, every endpoint, and examples.

Connect an AI assistant

Use Gleantap from Claude, ChatGPT, and other AI tools. No code needed.

Maintaining an older integration?

The v2 (legacy) API reference.

Find your API credentials

Step 1. Open Gleantap and click Settings in the top-right menu, then open the API tab.

Step 2. Your credentials are listed in a table. If the table is empty, click Generate New Key.

The table has two values:

Column	What it is	Used by
API Key	Your account ID	v2 API only (X-API-KEY header)
API Secret	Your secret credential	v3 API (Authorization: Bearer <API Secret>), MCP connections that use a key, and v2 (X-SECRET-KEY header)

Treat the API Secret like a password. It has full access to your account across every workroom. It can read all contacts, send messages, and delete data. Don't paste it into shared documents, browser code, or chat messages. If it leaks, delete it with the trash icon and generate a new one.

You can generate more than one secret, for example one per integration, so you can revoke one without breaking the others. Delete any you no longer use.

Only users whose role includes API access can see this tab. Ask an account admin if you don't see it.

Use the API (v3)

All new integrations should use the v3 API:

curl https://api.gleantap.com/v3/contacts?limit=5 \
  -H "Authorization: Bearer YOUR_API_SECRET"

Full details, including OAuth for third-party apps, are in Authentication and the API Reference on the developer site.

There is no separate test environment. Every API call runs against your real account. Try new integrations with a test contact or a test workroom before running them on real customers.

Connect an AI assistant (MCP)

You can connect Claude, ChatGPT, Cursor, and other AI tools to Gleantap so they can look up contacts, build segments, draft templates, and report on campaigns for you. In most tools you add this URL and sign in to Gleantap. No API secret is needed:

https://mcp.gleantap.com/mcp

See Use Gleantap with AI Assistants for step-by-step setup in Claude and ChatGPT. For other tools, or to connect with your API Secret instead of signing in, see the developer guide Connect AI Tools (MCP).

Older integrations (v2)

The v2 API (https://api.gleantap.com/v2/ExternalApi) is deprecated but still works. It uses three values on every request:

Where	Value
X-API-KEY header	API Key from Settings → API
X-SECRET-KEY header	API Secret from Settings → API
app_id in the request body	Your workroom ID: the 24-character ID at the end of your dashboard URL, for example 6993672aca1046edb9094d75 in https://app2new.gleantap.com/apps/newDashboard/6993672aca1046edb9094d75

v2 is limited to 1,000 calls per rolling 24 hours and returns 429 above that. The v2 reference is at developers.gleantap.com/v2. If you maintain a v2 integration, plan to move it to v3.

Support

For API help, integration questions, or higher rate limits, email [e-mail].