Introduction
NotiQ’s Public API lets you automate Google Maps lead discovery, campaign control, lead CRM fields, and Gmail send/reply from scripts, Clay, n8n, or AI agents.
Product: notiq.io · Dashboard & API keys: app.notiq.io
| Surface | What it is | Base |
|---|---|---|
| REST | HTTPS JSON API | https://api.notiq.io/public/v1 |
| MCP | Same operations as tools for Cursor / Claude / ChatGPT | https://mcp.notiq.io |
| Webhooks | Outbound POSTs when replies arrive, leads are tagged, or Gmail disconnects | Configured in-app |
How auth works
- Create an API key in the app at
/api-mcp(secret shown once). - Send it on every REST call:
X-API-Key: sk_live_…. - MCP uses the same key (
X-API-Key, or OAuth paste-key for Claude/ChatGPT).
What you can do
| Action | Method / path |
|---|---|
| Check credits | GET /credits |
| List Gmail accounts | GET /accounts |
| Recent activity | GET /activity |
| Insights overview | GET /insights/overview |
| List / get campaigns | GET /campaigns, GET /campaigns/:id |
| Launch Maps search | POST /campaigns |
| Start / pause outreach | POST …/start, POST …/pause |
| List / get / add / patch leads | GET/POST/PATCH …/leads (list: at most one of tag / replied / needsReply / excluded=true) |
| Batch add leads | POST …/leads/batch (1 credit per created) |
| Batch tag/exclude | POST …/leads/batch-update (0 credits) |
| Batch delete leads | POST …/leads/batch-delete (0 credits, irreversible, no refund) |
| Send Gmail | POST /inbox/messages |
| Receive events | Webhooks (reply.received, lead.tagged, account.disconnected) |
Credits: manual lead insert costs 1 on create (single or batch add); Maps discovery costs 1 per email lead found asynchronously; batch-update and batch-delete cost 0. Insights overview ranks a recent campaign sample — not all-time analytics.
What stays in the dashboard
- API key and webhook CRUD (
/api-mcp) - Connecting Gmail accounts
- Creating agents / message templates (
templateIdused by start)
Start here
- Quickstart — first successful
GET /credits - Authentication — keys and hosts
- Errors & Credits & rate limits
- Endpoints — full route contracts
- MCP — tool map for AI clients
- Connect Claude / ChatGPT — OAuth connector flow
- Webhooks — outbound events
- Examples — curl samples