Introduction
NotiQ’s Public API lets you automate Google Maps lead discovery, email validation, website enrichment, campaign control, lead CRM fields, and send/reply from a connected mailbox (Gmail, Outlook, or IMAP) 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 (48 tools, including MCP-only wait_for_campaign_leads) | https://mcp.notiq.io |
| Webhooks | Outbound POSTs when replies arrive, leads are tagged, or a sending account 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 |
|---|---|
| Setup readiness | GET /setup |
| Check credits | GET /credits |
| List sending accounts | GET /accounts (Gmail, Outlook, IMAP) |
| Connect / reconnect mailbox | POST /accounts/connect-link · …/reconnect-link (mailboxKind) |
| Validate one email | POST /tools/validate-email (mode=mx free; mode=full 1 credit on full API hit) |
| Validate many emails | POST /tools/validate-emails (max 100) |
| Enrich a website | POST /tools/enrich-website (0 credits) |
| Create / assign manual agents | POST /templates, POST …/template |
| Custom tags & overview goals | GET/POST /tags, POST …/overview-goal (Meeting booked) |
| Exclude desk | /excluded-leads, /excluded-domains |
| Recent activity | GET /activity |
| Insights overview | GET /insights/overview |
| List / get campaigns | GET /campaigns, GET /campaigns/:id |
| Launch Maps search or empty manual campaign | POST /campaigns, POST /campaigns/manual |
| 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 / tag / delete leads | POST …/leads/batch · batch-update · batch-delete |
| Send from connected mailbox | POST /inbox/messages |
| Receive events | Webhooks (reply.received, lead.tagged, account.disconnected) |
At call time, credits may be charged by manual lead create (1 per created) and by email validation (1 per full-validation API hit in mode=full; mode=mx and cache hits are free). Setup, templates, tags, goals, exclude desk, mailbox connect, ops, enrich, batch update/delete, start/pause, and send are 0 credits. Maps discovery still debits 1 per email lead found asynchronously. Insights overview ranks a recent campaign sample — not all-time analytics.
Prefer starting with GET /setup / MCP get_setup_status — see Agent setup.
What stays in the dashboard
- API key and webhook CRUD (
/api-mcp) - Full Auto agent knowledge / assets; archive custom tags
- Completing mailbox OAuth in the browser after a connect link
Start here
- Quickstart — first successful
GET /credits - Agent setup — one-prompt MCP runbook
- Authentication — keys and hosts
- Errors & Credits & rate limits
- Endpoints — full route contracts
- MCP — 48 tools for AI clients
- Connect Claude / ChatGPT — OAuth connector flow
- Webhooks — outbound events
- Examples — curl samples