How Do I Connect Providers?
Zenoo Studio acts as an orchestration layer that routes checks to external verification providers. Before you can use a provider in your flows, you need to connect it with API credentials and configure its settings.What you’ll learn
- Which provider types are supported
- How to add a new provider
- How to configure timeout, retry, and batch settings
- How to test the connection
- How to enable a provider in your flows
What providers does Zenoo support?
Zenoo supports providers across several verification categories:| Category | Providers | What they do |
|---|---|---|
| Screening | WorldCheck, ComplyAdvantage, Sumsub | PEP, sanctions, adverse media, and watchlist screening |
| Company Registry | Kyckr | Company registration lookup, director/UBO extraction |
| Identity | Document verification providers | ID document capture, OCR, authenticity checks |
| Biometric | Liveness detection providers | Selfie matching, liveness verification, deepfake detection |
| Address | Address verification providers | Proof of address validation |
New providers can be added to the platform without code changes. Each provider is implemented as an adapter that follows a standard interface, making the system extensible.
How do I add a provider?
Navigate to Provider Settings
From the Studio dashboard, open Settings in the left navigation, then select Providers. You will see a list of configured providers and an Add Provider button.
Select the provider type
Click Add Provider and choose from the available provider catalog. Each entry shows:
- Provider name and logo
- Categories supported (screening, identity, company, etc.)
- Whether it operates in individual or batch mode
Enter API credentials
Fill in the credentials for your provider account:
- API Key / API Secret — provided by the vendor when you sign up
- Environment — select Staging or Production (use staging for testing)
- Base URL — pre-filled for known providers, editable for custom endpoints
Configure timeouts and retries
Set operational parameters for the provider:
- Timeout (seconds) — how long to wait for a response before treating the call as failed (default: 30 seconds)
- Max retries — how many times to retry on transient failures (default: 3)
- Retry delay — seconds between retry attempts
Configure batch mode (if applicable)
Some providers support batch mode, where a single API call returns results for multiple check types. For example, WorldCheck returns PEP, Sanctions, and Adverse Media results in one call.If your provider supports batch mode:
- Toggle Category Batch Mode on
- Select which check types should be grouped in a single call
Test the connection
Click Test Connection. Studio sends a test request to the provider’s API using your credentials and displays:
- Connection status — success or failure
- Response time — how long the test took
- Error details — if the test failed, what went wrong (invalid credentials, network error, timeout)
How do I switch providers?
If you need to change a provider (e.g., migrating from one screening vendor to another):- Add and test the new provider using the steps above
- Open your flow in the builder
- Click each check node that uses the old provider
- Change the Provider dropdown to the new provider
- Save and test the flow
- Deactivate the old provider once you confirm everything works
Check results from the old provider remain attached to their original cases. Switching providers only affects new flow executions.
What’s next?
Build Your First Flow
Use your connected provider in a verification flow.
Screen for Sanctions
Configure screening nodes with your screening provider.
Go-Live Checklist
Verify all providers are configured with production credentials before launch.
Brand Your Experience
Customize the customer-facing verification journey.