Once you have an access key, Zapier can do two things. It can react when something happens in VisionScaper, or it can add leads and customers to VisionScaper.

Note: Zapier’s own help pages could not be opened here, so Zapier’s screen names below come from VisionScaper’s built-in guide and Zapier’s product page. Exact Zapier labels are unverified.

• A VisionScaper access key with Set up alerts (needed by Zapier) ticked (see “Make a VisionScaper access key for Zapier”).
• The three addresses from Settings → Connect other tools → Zapier: Subscribe address, Unsubscribe address, and Sample address. Each has a copy box. The tab How it works shows the Starting address.

1. In Zapier add a step using Webhooks by Zapier (or a private Zapier app) and choose Custom Request, as VisionScaper’s guide says.
2. Send a POST to the Subscribe address.
3. Add a header named Authorization with the value Bearer then your key (the word Bearer, a space, the key).
4. In the body, send an event (one of the names above) and the address Zapier gave you for that trigger, as target_url (hookUrl also works). Keep the body JSON.
5. VisionScaper answers with an id. Keep it for the unsubscribe step.
6. When the Zap is turned off, send a POST to the Unsubscribe address with the same header and the id.
7. To test before real data exists, GET the Sample address followed by the event name (for example lead.created). It lists your newest real records, or one marked example.

1. Use a Custom Request with a POST to the leads or customers address shown on the How it works tab.
2. Add the same Authorization: Bearer <key> header and send JSON.
3. A person with the same email or phone is never added twice. VisionScaper tells you who already exists. Add an Idempotency-Key header so a retry does not duplicate.

• VisionScaper retries a failed alert after 1 minute, 5 minutes, 30 minutes, 2 hours and 6 hours, then gives up. After 10 failures in a row the alert is switched off and you are emailed.
• Zapier’s Zap-off signal (a 410 answer) removes the subscription.
• Over the hourly limit you get 429 with a Retry-After header. If the plan has none, you get 402. The limit is a placeholder, not approved.
• Alerts are signed with X-VisionScaper-Signature: t=<time>,v1=<code>. The code is HMAC-SHA256 of <time>.<body> using the alert’s signing secret.

• 404 invalid_event. The event name has a typo.
• 403 insufficient_scope. Tick the matching “Look at” box on the key.
• Nothing fires. Check that the subscription shows under Alerts to other tools with “From Zapier” and “On”.

• Plugin: assets/js/api-platform.js; includes/modules/api-platform.php (routes zap/subscribe, zap/unsubscribe, zap/poll).
• Zapier, Webhooks by Zapier: https://zapier.com/apps/webhook/integrations (read 2026-10-15)

• Make a VisionScaper access key for Zapier
• Get your QuickBooks Client ID and Client Secret