Connect SuperBot to 7,000+ apps

01

Authentication

Create an API key in your dashboard under Integrations → API keys. Only workspace owners and admins can create or revoke keys. A key is shown once; SuperBot stores only its hash. Send it on every request:

X-API-Key: <your SuperBot API key>

Test a key, and get the label Zapier shows for the connection:

GET https://superbotapp.ai/api/zapier/me

02

Triggers (REST hooks)

• new_lead

  New Lead. A lead is captured by your bot or a form.

• new_conversation

  New Conversation. A visitor starts a new conversation.

• conversation_escalated

  Conversation Escalated to Human. A conversation is handed off to your team.

Subscribe a Zap (target must be a https://hooks.zapier.com URL):

POST https://superbotapp.ai/api/zapier/hooks
{ "event": "new_lead", "target_url": "https://hooks.zapier.com/..." }

DELETE https://superbotapp.ai/api/zapier/hooks/{id}

Recent records, used for Zap samples, in the same shape as live deliveries:

GET https://superbotapp.ai/api/zapier/triggers/{trigger}?limit=10

Leads carry id, name, email, phone, company, source, status, score, message, created_at, dashboard_url. Conversations carry id, visitor_name, visitor_email, message, channel, status, priority, created_at, dashboard_url. Each delivery is signed; a 410 reply from Zapier switches the subscription off.

03

Actions

POST https://superbotapp.ai/api/zapier/actions/training-answer
{ "question": "Do you ship to Canada?", "answer": "Yes, in 5-8 business days.", "category": "shipping" }

question and answer are required; category defaults to general. If the question already exists, its answer is updated instead of duplicated.

POST https://superbotapp.ai/api/zapier/actions/lead
{ "email": "jane@example.com", "name": "Jane", "phone": "", "company": "", "source": "zapier", "status": "new", "notes": "" }

A name or email is required; status is one of SuperBot's lead statuses (default new). An existing lead with the same email is returned instead of a duplicate, and leads created this way do not fire the New Lead trigger, so a Zap cannot loop.

04

Errors and limits

Errors return JSON with a plain-English message: 400 for invalid input, 401 for a missing or revoked key, 404 for an unknown id, and 429 when a key sends too many requests (retry after the Retry-After header). Every request is scoped to the key's own workspace.

05

Questions

Email support@superbotapp.ai or open a conversation. See our privacy policy for how data is handled.