New You can now talk to your Gelee agent from Claude, ChatGPT or Cursor through our MCP. Read the docs →

Gelee API v1

Overview

Everything you can do in the Gelee app, from your own code. Read every lead with its whole story, send and edit LinkedIn messages, run campaigns and seats, set up the AI SDR, and get a webhook the moment anything happens. JSON over HTTPS with a Bearer key.

Last updated 22 October 2026

Download api.mdSwitching from another tool?
Base URLhttps://www.gelee.ai/api/v1
AuthAuthorization: Bearer gk_…
FormatJSON
MCPweb.gelee.ai/api/v1/mcp

Your first call

Make a key in the Gelee app under Settings, Integrations, API Keys. Pick Read to look, Read + write to change things, or Read + write + send messages if your code will message people. Then check it works:

curl "https://www.gelee.ai/api/v1/me" \
  -H "Authorization: Bearer gk_your_key"
Response
{ "data": {
    "org_id": "0f2c…",
    "workspace": { "id": "0f2c…", "name": "Acme Growth" },
    "key": { "id": "k_81…", "scope": "read_write" },
    "scope": "read_write",
    "api_version": "v1",
    "seats": [ { "seat_id": "SExF…", "name": "Sofia Salazar",
                 "public_identifier": "sofiasalazar",
                 "linkedin_url": "https://www.linkedin.com/in/sofiasalazar",
                 "connected": true, "sales_navigator": false } ] } }
Use www.gelee.ai, not gelee.ai

The bare domain redirects, and most HTTP clients drop the Authorization header when they follow a redirect to another host, so your key would be silently lost.

What you can build

Sync leads to your CRM
Every lead with sender, campaign, timeline, booking, score and flags. Write fields, tags and outcomes back.
Run your own inbox
Read whole threads, reply, start conversations and InMails, approve or skip the AI's drafts.
Feed your own sourcing
Push leads from any tool. Gelee enriches, filters and runs the outreach.
Build campaigns from code
Create, edit, launch and pause. See what each step and variant books.
Manage seats and the AI SDR
Limits, warm-up, teammates, reply mode, knowledge and objections.
React in real time
Replies, bookings, accepts, sends and lead changes, signed, with the full story on each.

Using an AI agent?

Give your agent the whole reference as one Markdown file: www.gelee.ai/api.md. Agents that look for llms.txt will find it too. To let Claude or ChatGPT run your workspace directly, connect the Gelee MCP server.

How every endpoint behaves

  • Successful answers are wrapped as { "data": … }. Lists add pagination.
  • Errors are { "error": { "code", "message" } }, always in plain words. See Errors.
  • A key only ever sees its own workspace. Anything from another workspace answers 404, exactly like something that does not exist.
  • Anything unknown about a person is null, never left out, so every row has the same shape.
  • Sends take an Idempotency-Key header, so a retry never messages someone twice.