Skip to main content


In this comprehensive guide, we'll navigate you through the essential steps to kickstart your journey with the Synaps API.

If you want to create an app and build your verification flow, refer to App and Verification Flow.

1. Get your API Key

  1. In your app dashboard, click on Integration

  2. At this stage, you have only the Sandbox API key available. This API Key is useful during the integration period. It helps you trigger different outcome of the verification flow in order to integrate seamlessy with your system for any case. Api Key


Sandbox mode is not intendend for production use. It is designed for developers to experiment with various integration results

  1. Your API Key is highly confidential and grants you access to sensitive personal user data. As such, it's imperative not to disclose it to anyone. Ensure it doesn't get uploaded to your source control system and is stored securely at all times.

2. Init a verification session


A verification session is a unique identifier intendend to track user's progress during the verification process. It must be linked to a unique user.

  1. Call the /v4/session/init endpoint with your favorite language
curl --location --request POST '' \
--header 'Api-Key: YOUR_API_KEY'

API Response

"session_id": "7cf6c33f-dff8-422d-a696-370db77782d8",
"sandbox": true

3. Setup Verify SDK

The Synaps Verify SDK is a fully-featured user verification interface. As a plug & play component, it allows seamless integration on your platform within few minutes.

Verify SDK

Refer to the Verify SDK section to learn more about the integration.

4. Configure webhooks


Webhooks are server-to-server HTTP callbacks enabling real-time data updates between applications upon specific event triggers.

To avoid you reaching Rate Limit, you must setup webhooks notification system. Each time there is a state changes on Synaps side, Synaps will trigger your webhook to notify you that something changed. You can then synchronize data from Synaps API to your database.

  1. Add your notification URL

Make sure to add an https endpoint and check Synaps secret each time you receive a wehbook


  1. Congratulations! You successfully added your notification URL.

Read webhooks API reference

5. Synchronize data

Get session session details to get an overview of the verification progress

Read API reference for Get session details

"app": {
"name": "WeStart",
"id": "990517996973"
"session": {
"id": "7cf6c33f-dff8-422d-a696-370db77782d8",
"sandbox": true,
"steps": [
"id": "LIV9905179969733470",
"type": "LIVENESS"
"id": "IDD9905179969738103",
"type": "ID_DOCUMENT"
"id": "POA9905179969733505",

Once you get the global status of the verification session, you can get in-depth details for each verification step by using Get step details

Read Get step details API reference

What's next?

Great, you're now set up with the Synaps API and you have successfully initalized the Verify SDK.

Promote to production

Explore the API reference