Customers
Create Customer
POST
/v1/customers/Authorization
X-Api-Key
string required
API key generated in the Developers section of the Stablegate app. Send it in the
X-Api-Key header on every request; the partner API does not require request signing.Request body
type
string required
One of:
individual, corporateemail
string<email> required
country_code
string | null
first_name
string | null
last_name
string | null
company_name
string | null
phone
string | null
external_reference
string | null
Responses
Successful Response
uuid
string<uuid> required
customer_id
string | null
external_reference
string | null
username
string required
full_name
string | null
email
string | null
phone
string | null
type
string | null
One of:
individual, corporatestate
string required
One of:
new, active, blocked, limited, closedcountry_code
string | null
email_verified
boolean required
created_at
string<date-time> required
Validation Error
trace_id
string required
error_code
string required
One of:
devapi_internal_error, devapi_request_validation_error, devapi_iban_parse_error, devapi_customer_close_error, devapi_bank_code_required_error, devapi_download_aol_error, devapi_not_found_error, devapi_bad_request_error, devapi_email_occupied_error, devapi_idempotency_invalid_key, devapi_idempotency_key_misuse, devapi_idempotency_request_in_progress, devapi_kyc_application_link_error, devapi_instant_verification_error, devapi_unauthorized_error, devapi_forbidden_error, devapi_method_not_allowed_error, devapi_service_unavailable_errormessage
string required
details
object[] required
loc
string | string[] required
msg
string required
type
string required
curl https://api.stablegate.com/v1/customers/ \
--request POST \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"type": "individual",
"email": "[email protected]",
"country_code": "string",
"first_name": "string",
"last_name": "string",
"company_name": "string",
"phone": "string",
"external_reference": "string"
}'
{
"uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"customer_id": "string",
"external_reference": "string",
"username": "string",
"full_name": "string",
"email": "string",
"phone": "string",
"type": "individual",
"state": "new",
"country_code": "string",
"email_verified": true,
"created_at": "2026-01-01T00:00:00Z"
}
{
"trace_id": "string",
"error_code": "devapi_internal_error",
"message": "string",
"details": [
{
"loc": "string",
"msg": "string",
"type": "string"
}
]
}