VisaFlow developer docs
Send leads to your VisaFlow workspace from your website, your own systems or your ad tools, read them back, and get told the moment something changes.
Base URL
https://api.visaflow.work
All requests go to this host. JSON bodies use snake_case field names.
- QuickstartCreate a test key and send your first lead in five minutes.
- AuthenticationKey types, scopes, allowed websites and IP lists.
- Rate limitsLimits per key and per visitor, headers, and the monthly lead quota.
- ErrorsThe error body and what each code means.
- IdempotencyRetry safely without creating the same lead twice.
- WebhooksGet events in real time and check their signatures.
- Embed widgetA ready-made lead form you add with one script tag.
- API referenceEvery endpoint, generated from the live OpenAPI document.
Two kinds of keys
- Public keys (vf_live_pub_ or vf_test_pub_) go in browser code. They can only create leads, only from the websites you allow, and need a captcha token.
- Secret keys (vf_live_ or vf_test_) stay on your server. Depending on their scopes they create, read and update leads, read application status and manage webhooks.
- Test keys run every check but never create real leads. Use them while you build.