Skip to main content

Using the Knock2 REST API

Query your Knock2 accounts, contacts, and activity programmatically with the REST API.

Written by Sara

Knock2 offers a REST API so you can access your visitor data programmatically — without logging into the dashboard. It's ideal for building custom integrations, syncing data into your own systems, or powering internal tools.


What you can do

  • List, search, and filter your accounts and contacts (with pagination)

  • Get full account and contact details, including UTMs, page visits, tech stack, and CRM data

  • Enrich a contact on demand from an email address

  • Read visitor activity and page-visit history

  • Read and create filter sets, and read lead scores and webhook configuration


Getting your API key

  1. Go to Settings → Integrations → API.

  2. Click Create Key and give it a name.

  3. Copy the key and store it somewhere safe — you won't be able to see it in full again.

You can revoke a key at any time from the same screen.


Authenticating

Pass your key as a bearer token in the Authorization header on every request:

Authorization: Bearer YOUR_API_KEY

All endpoints live under the /v1/ base path. The interactive API reference (linked from the API settings page) documents every endpoint, parameter, and response.


Good to know

  • Requests are rate limited — build in ret/backoff handling for high-volume jobs.

  • List endpoints use cursor-based pagination; follow the cursor to page through all results.


Questions?

Building something with the API? Message us in Intercom or email support@knock2.ai and we'll help.

Did this answer your question?