Create User
Create user profiles programmatically via the API instead of the widget. When a user is created through this endpoint, light KYC (LKYC) verification happens automatically behind the scenes. This streamlines the onboarding flow so that when end-users subsequently open the widget, they can skip identity verification and proceed directly to entering payment information or completing checkout, significantly reducing friction and increasing conversion rates. Additionally, this endpoint allows you to capture the user_id directly from the response payload and store it immediately in your own database for seamless cross-system reconciliation. Contact our support team to request this feature for your Partner ID.
Endpoints
| Environment | Method | Endpoint |
|---|---|---|
| Sandbox | POST | https://partner-sandbox.wert.io/api/external/users/create |
| Production | POST | https://partner.wert.io/api/external/users/create |
Limits
Important!
- Your users must agree to share their personal data with Wert.
- Non-English characters should be standardized to English before passing to the API.
Body
boolean RequiredIndicates whether the user has accepted the terms of service.
Possible values: true, false
string RequiredThe user's phone number with country code.
Possible values: For example, +1234567890
string RequiredThe user's email address.
Possible values: For example, [email protected]
string RequiredThe user's first name.
Possible values: 2–30 characters; A-Z, a-z, 0-9; No special characters (?, @, #, $, etc.); Cannot be all numeric.
string OptionalThe user's middle name.
Possible values: 2–30 characters; A-Z, a-z, 0-9; No special characters (?, @, #, $, etc.); Cannot be all numeric.
string RequiredThe user's last name.
Possible values: 2–30 characters; A-Z, a-z, 0-9; No special characters (?, @, #, $, etc.); Cannot be all numeric.
string RequiredThe user's date of birth.
Possible values: YYYY-MM-DD, for example 1990-01-01.
string RequiredThe user's country of residence.
Possible values: Click to see alpha-3 country code, for example DEU, USA, RUS.
string RequiredThe user's state of residence.
Possible values: Click to see alpha-2 US state code, for example AZ, AK, CA.
string OptionalTaxpayer Identification Number. For USA, a Social Security number: dashes and spaces are ignored, and exactly 9 digits are stored as 000-00-0000. For any other country, the trimmed value is stored as given. A blank value is rejected. The value is not returned.
Example Request
curl -X POST '[https://partner.wert.io/api/external/users/create](https://partner.wert.io/api/external/users/create)' \
-H 'X-Api-Key: your-unique-api-key' \
-H 'Content-Type: application/json' \
-d '{
"has_accepted_terms_of_service": true,
"phone": "+1234567890",
"email": "[email protected]",
"first_name": "John",
"middle_name": "Paul",
"last_name": "Doe",
"date_of_birth": "1990-01-01",
"country_of_residence": "USA",
"state_of_residence": "CA",
"tin": "000-00-0000"
}'Response
stringTimestamp of when the user was created (UTC).
Possible values: 2026-06-02T08:44:43.000Z
stringThe unique identifier for the created user in Wert's database.
Possible values: 01KT3R3BQ2ZRBHZN58E6VVY5F3
Example Response
{
"created_at": "string",
"user_id": "string",
}References
User Create Errors
Refer to user creation error codes for more details.
{
"field": "phone",
"message": "Invalid phone format"
}{
"field": "email",
"message": "Invalid email format"
}{
"field": "date_of_birth",
"message": "Invalid date_of_birth format"
}{
"field": "first_name",
"message": "Invalid first_name format"
}{
"field": "country_of_residence",
"message": "Invalid country_of_residence format"
}{
"field": "tin",
"message": "Invalid tin"
}{
"message": "ERR_UNAUTHORIZED"
}{
"field": "has_accepted_terms_of_service",
"message": "user must accept the terms of service"
}{
"field": "country_of_residence",
"message": "restricted country"
}{
"field": "partner_id",
"message": "user creation is not allowed"
}{
"message": "A user with this phone already exists",
"user_id": "USER_ID",
"created_at": "{creation date and time}"
}User Create Error Codes
| Error Code | Description |
|---|---|
400 | Bad request. Ensure all required fields are present and meet validation criteria. |
401 | Unauthorized. Check your API key or contact support. |
403 | Forbidden. Ensure the user is 18+ years old, country and state are supported, and the user has accepted the terms and conditions. |
409 | Conflict. A user with the same phone number may already exist. |
429 | Too Many Requests. Retry later. |
500 | Internal Server Error. |
Updated about 16 hours ago

