What’s available
Triggers (fire a Zap when something happens in Usertour — all instant):- Flow Started / Flow Completed / Flow Ended — a user starts, completes, or leaves a flow
- Checklist Completed — a user finishes every task of a checklist
- Survey Question Answered — a user answers a survey question (NPS, scale, text, choice)
- Launcher Activated — a user clicks or hovers over a launcher
- User Created — Usertour sees a user for the first time
- Event Tracked — any event definition in your project fires, custom events included
- Create or Update User — set attributes you can target content with
- Create or Update Company
- Track Event — record a behavior event; unseen users are created, unknown event names register a definition on first use
Connect
- Accept the Usertour app invite link (below) with your Zapier account, or find Usertour when adding a Zap step.
- In Usertour, create an API token under Settings → API. Give it the Webhooks: manage scope for triggers (plus Events: read for Event Tracked), and Users: read/write, Companies: read/write, and Attributes: read for the actions and searches you use; include the environments you want to connect.
- When Zapier asks you to connect your account: keep the default Server URL on Usertour Cloud (self-hosted instances enter their own API URL), and paste the token.
- Pick your project and environment in each Zap step — the dropdowns list exactly what your token can access.
How triggers work
Turning a Zap on creates an ordinary webhook in that environment, labeled “Managed by Zapier” — you’ll see it under Settings → Webhooks, message log included, and delivery gets the same retry and circuit-breaker treatment as any webhook. Turning the Zap off removes it. Don’t delete that webhook by hand: the Zap silently stops firing.Troubleshooting
- A Zap stopped firing: check Settings → Webhooks — if the “Managed by Zapier” entry is missing (deleted by hand) or auto-disabled, turn the Zap off and on again to re-subscribe.
- The connection test fails: the token may lack the required scopes or environments, or (self-hosted) the Server URL isn’t reachable from the public internet — Zapier’s servers must be able to call your instance.
- Rotated or deleted the API token: reconnect the Usertour account in Zapier with a fresh token; existing Zaps pick the connection back up.