Applicant → Create an Applicant
AI-generatedOverview
This node integrates with the Sumsub API to create a new applicant record. It is designed to send applicant data to Sumsub's verification system, which is commonly used for identity verification and compliance checks. This node is beneficial in scenarios where you need to onboard users or customers by submitting their personal information for automated verification processes.
For example, a financial service platform can use this node to create an applicant profile in Sumsub when a new user registers, triggering identity verification workflows seamlessly within an automation.
Properties
| Name | Meaning |
|---|---|
| Level | The verification level or workflow stage to assign the applicant to. |
| Body | A JSON object containing the detailed applicant data to be submitted to Sumsub. |
Output
The node outputs the response from the Sumsub API after creating the applicant. This output is structured as JSON and typically contains details about the newly created applicant, such as their unique ID and status within the verification process.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating requests to the Sumsub API.
- The node sends HTTP POST requests to
https://api.sumsub.com/resources/applicants. - Proper configuration of the API key credential in n8n is necessary for successful operation.
Troubleshooting
Common issues:
- Missing or invalid API key credential will cause authentication failures.
- Incorrectly formatted JSON in the "Body" property may result in request errors.
- Providing an invalid or unsupported "Level" value could lead to API rejections.
Error messages:
- Authentication errors typically indicate problems with the API key; verify that the credential is correctly set up.
- Validation errors from the API often point to malformed JSON or missing required fields in the applicant data; ensure the JSON body matches Sumsub's expected schema.
- Network or connectivity errors suggest checking internet access and endpoint availability.
Links and References
- Sumsub API Documentation – Official API reference for understanding request and response formats.
- Sumsub Identity Verification – Overview of Sumsub’s identity verification services.