Users
Create a new user
Creates a new user in the system
X-API-KEY<token>
API key for authentication (prefix: sk_dev_ for development, sk_live_ for production)
In: header
referenceId?string
Optional reference ID
Format
uuidemailstring
Format
emailfirstName?string
Length
length <= 100lastName?string
Length
length <= 100businessName?string
Length
length <= 100typestring
Value in
"INDIVIDUAL" | "BUSINESS"capabilities?array<UserCapability>
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://api.sentra.xyz/api/v1/users" \ -H "Content-Type: application/json" \ -d '{ "email": "user@example.com", "type": "INDIVIDUAL" }'{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"email": "user@example.com",
"firstName": "string",
"middleName": "string",
"lastName": "string",
"businessName": "string",
"type": "INDIVIDUAL",
"kycStatus": "NOT_STARTED",
"kycUrl": "http://example.com",
"phoneNumber": "string",
"phoneCountryCode": "string",
"capabilities": [
"USD"
],
"address": {
"addressLine1": "string",
"addressLine2": "string",
"city": "string",
"state": "string",
"postalCode": "string",
"countryCode": "string"
},
"metadata": {},
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}{
"message": "Validation failed",
"statusCode": 400,
"details": {
"field": "email",
"message": "Invalid email format"
}
}{
"message": "Unauthorized",
"statusCode": 401
}{
"message": "Internal server error",
"statusCode": 500
}