# NotiQ API

> Public API + MCP reference for NotiQ Google Maps outreach, email validation, and website enrichment.

Base URL: https://api.notiq.io/public/v1
MCP: https://mcp.notiq.io
Auth header: X-API-Key: sk_live_…
Keys: https://app.notiq.io/api-mcp
Product: https://notiq.io
OpenAPI: https://docs.notiq.io/openapi.yaml
Docs: https://docs.notiq.io
Sitemap: https://docs.notiq.io/sitemap.xml

## Pages

- [Introduction](https://docs.notiq.io): NotiQ Public API and MCP — Maps discovery, email validation, website enrichment, campaigns, activity, insights, batch add/update/delete leads, Gmail, and webhooks.
- [Authentication](https://docs.notiq.io/authentication): Authenticate with X-API-Key (sk_live_…). Keys are created at /api-mcp.
- [Changelog](https://docs.notiq.io/changelog): Notable changes to the NotiQ Public API and this documentation.
- [Connect Claude / ChatGPT](https://docs.notiq.io/connect-claude): Connect Claude.ai, Claude Desktop, or ChatGPT to NotiQ MCP — paste your API key on NotiQ’s consent page, not in OAuth Client ID/Secret.
- [Credits & rate limits](https://docs.notiq.io/credits-and-rate-limits): Credit costs, RPM classes, idempotency, and pagination for the Public API.
- [Endpoints](https://docs.notiq.io/endpoints): NotiQ Public API v1 route index — 20 operations, base URL, auth, and links to every endpoint.
- [GET /accounts](https://docs.notiq.io/endpoints/get-accounts): List connected Gmail accounts for the workspace.
- [GET /activity](https://docs.notiq.io/endpoints/get-activity): Workspace activity feed (filter by type; use reply_received for last reply).
- [GET /campaigns/:campaignId](https://docs.notiq.io/endpoints/get-campaign): Get a single campaign by id.
- [GET /campaigns](https://docs.notiq.io/endpoints/get-campaigns): List campaigns with optional status filter and cursor pagination.
- [GET /credits](https://docs.notiq.io/endpoints/get-credits): Return remaining credits for the workspace.
- [GET /insights/overview](https://docs.notiq.io/endpoints/get-insights-overview): Sampled campaign rankings and workspace highlights (not all-time analytics).
- [GET /campaigns/:campaignId/leads/:leadId](https://docs.notiq.io/endpoints/get-lead): Get a single lead by id, including timestamps, excluded, phone, and messageSent.
- [GET /campaigns/:campaignId/leads](https://docs.notiq.io/endpoints/get-leads): List leads with optional filters, sort, and cursor pagination (including excluded=true).
- [PATCH /campaigns/:campaignId/leads/:leadId](https://docs.notiq.io/endpoints/patch-lead): Update lead tag or excluded flag. Zero credits.
- [POST /campaigns/:campaignId/leads](https://docs.notiq.io/endpoints/post-add-lead): Add a lead by email. Charges 1 credit when status is created.
- [POST /campaigns/:campaignId/leads/batch](https://docs.notiq.io/endpoints/post-add-leads-batch): Bulk add up to 100 leads by email (1 credit per create).
- [POST /campaigns](https://docs.notiq.io/endpoints/post-campaigns): Launch a Google Maps search campaign. Discovery continues asynchronously.
- [POST /campaigns/:campaignId/leads/batch-delete](https://docs.notiq.io/endpoints/post-delete-leads-batch): Permanently delete up to 100 leads (0 credits, no refund).
- [POST /tools/enrich-website](https://docs.notiq.io/endpoints/post-enrich-website): Fetch a public website homepage and light follow-on pages for personalization. 0 credits.
- [POST /campaigns/:campaignId/pause](https://docs.notiq.io/endpoints/post-pause-campaign): Pause a campaign in CAMPAIGN_IN_PROGRESS. Zero credits.
- [POST /inbox/messages](https://docs.notiq.io/endpoints/post-send-message): Send or reply via connected Gmail. Zero credits; irreversible.
- [POST /campaigns/:campaignId/start](https://docs.notiq.io/endpoints/post-start-campaign): Start or resume campaign outreach. Zero credits.
- [POST /campaigns/:campaignId/leads/batch-update](https://docs.notiq.io/endpoints/post-update-leads-batch): Tag and/or exclude up to 100 leads (0 credits).
- [POST /tools/validate-email](https://docs.notiq.io/endpoints/post-validate-email): Validate one email. mode=mx is free; mode=full charges 1 credit only on a ZeroBounce API hit.
- [POST /tools/validate-emails](https://docs.notiq.io/endpoints/post-validate-emails): Validate up to 100 emails. Same credit rules as single validate; HTTP 200 with per-item outcomes.
- [Errors](https://docs.notiq.io/errors): Error envelope, codes, and how to branch on error.code for the NotiQ Public API.
- [MCP](https://docs.notiq.io/mcp): NotiQ MCP tools mirror Public REST 1:1 — 20 tools including validate_email, validate_emails, and enrich_website (validation can charge credits).
- [Quickstart](https://docs.notiq.io/quickstart): Create a key, check credits, and make your first Public API calls — including email validation, website enrichment, activity, insights, and batch leads.
- [Webhooks](https://docs.notiq.io/webhooks): Outbound NotiQ webhooks — reply.received, lead.tagged, account.disconnected with static X-Webhook-Signature.
- [Connect MCP (Cursor)](https://docs.notiq.io/examples/mcp-connect): Cursor mcp.json snippet for NotiQ MCP with X-API-Key.
- [Quickstart with curl](https://docs.notiq.io/examples/quickstart-curl): Copy-paste curl samples for credits, campaigns, batch leads (add/update/delete), email validation, website enrichment, activity, insights, and inbox.

## Notes

- Branch on error.code, not HTTP status alone.
- Unknown JSON keys are rejected.
- Webhook subscriptions are configured in the dashboard.
- Prefer MCP tools for coding agents (ChatGPT, Claude).