Requires an API key with access to the API v2 — available on the Standard and Premium plans (see Introduction to the API).
Connect your account
- In ChatNorris, go to Settings → API Keys and create a key. Write it down: it’s shown only once.
- In Zapier, search for the ChatNorris app when you create a Zap.
- Paste the API key into the connection’s API Key field. Zapier tests the connection against
GET /api/v2/projectand, if it’s valid, shows your organization’s name. - You can reuse the same connection in several Zaps.
Triggers
Triggers work by polling: Zapier queries the API at the interval that applies to your Zapier plan, and automatically deduplicates results it has already seen.
The Agent field is a dropdown that loads the actual list of your agents (it uses
chatbots:read internally); leave it empty to listen to all of the organization’s agents.
New Conversation also fires for conversations created through the API itself (
api channel) — for example, if another integration uses the Send Message action to start a new conversation.Action: Send Message
Sends a message to an agent and waits for its reply — the samePOST /api/v2/chatbots/:id/chat from the API.
The action returns
reply (the agent’s reply) and conversation_id, which you can chain into the rest of the Zap — for example, to forward the reply by email or Slack, or to reuse it as Conversation ID in a later step to keep the thread.
Requires the chat:write scope.
Permissions each part uses
API keys created in Settings → API Keys have full access (
*), so they cover all these uses: you don’t need to choose permissions.
Known limitations
- There’s no “new message” trigger within a conversation — only new conversation and new lead.
- There’s no action to update an existing lead: the public API v2 doesn’t expose that endpoint yet.
- Lead data comes with the base fields (name, email, phone, date) plus
contact_properties(company, job title, city, etc.) andcustom_fields; they don’t come flattened field by field unless you map them manually in the Zap.
See also
- Introduction to the API — authentication, scopes and response format.
- n8n — a self-hosted or open-source alternative to Zapier, with more operations (knowledge base included).

