API overview
The GraphKit REST API v1, for pushing leads from your CRM, enrolling them in campaigns, reading the inbox and receiving signed webhooks.
The GraphKit API lets other systems work with a workspace: create and merge leads, add them to lists and campaigns, read campaign stats, read conversations and send replies, and manage webhook endpoints. Building and launching campaigns and connecting accounts stay in the app, where people review the sequence and the account owner confirms the connect statements.
Selling domains and mailboxes?
The Infrastructure API is a separate, self-serve API for buying domains and Google Workspace or Microsoft 365 mailboxes from your own product, with its own gk_test_ and gk_live_ keys and a prepaid balance. Start with the Infrastructure API guide.
Base URL
https://app.graphkit.com/api/v1On a white-label domain the API is also served under that domain, for example https://app.youragency.com/api/v1.
Quickstart
Create a key
In the workspace, open Settings → API keys, choose Create API key, pick the scopes and copy the key. It starts with gk_live_ and is shown once.
Check it
curl -s https://app.graphkit.com/api/v1/me \
-H "Authorization: Bearer $GRAPHKIT_API_KEY"The response names the key's workspace and scopes.
Push a lead and enroll it
curl -s -X POST https://app.graphkit.com/api/v1/leads \
-H "Authorization: Bearer $GRAPHKIT_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: crm-contact-4711" \
-d '{"firstName":"Jane","lastName":"Doe","companyName":"Northwind",
"identities":[{"channel":"linkedin","value":"https://www.linkedin.com/in/jane-doe"}]}'
curl -s -X POST https://app.graphkit.com/api/v1/campaigns/$CAMPAIGN_ID/leads \
-H "Authorization: Bearer $GRAPHKIT_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: enroll-4711" \
-d '{"leadIds":["'"$LEAD_ID"'"]}'Get told about replies
Create a webhook endpoint subscribed to lead.replied and message.received.
What is in this section
Authentication
API keys, scopes and what a key can see.
Conventions
Errors, pagination, idempotency and rate limits.
Webhooks
Events, signatures, retries and redelivery.
Endpoints
Every v1 endpoint, generated from the OpenAPI spec.
OpenAPI
The v1 API is described by an OpenAPI 3.1 document at /openapi.json (also as YAML). Use it to generate a client in your language or import it into Postman or Insomnia. The endpoint reference is generated from the same document.
Versioning
/api/v1 only changes in backwards-compatible ways: new endpoints, new optional request fields, new response fields and new event types. Write clients that ignore fields they do not know. Breaking changes will ship as /api/v2.
No-code tools
GraphKit has no native Zapier, Make or n8n apps yet. Use the tool's webhook trigger ("Catch Hook" in Zapier, "Custom webhook" in Make, "Webhook" in n8n) as a webhook endpoint, and its HTTP step for API calls with a key that has only the scopes it needs. Send an Idempotency-Key, because these tools retry failed steps.