Create Customer

post

https://api-test.turaco.insure/api/v1/customers

Send customer KYC information - this only creates a customer without a policy. This customer will be treated as a lead.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

fullName

string

required

Customer's full name

mobileNumber

string

required

^(\+\d{1,3}[- ]?)?\d{10}$

Customer's mobile number

gender

string

enum

Customer's gender

Allowed:

dateOfBirth

date

Customer's date of birth

age

number

Customer's age - if date of birth is unavailable

string

Customer's email

idNumber

string

Customer's national ID / passport number

customerIdentifier

string

Customer's unique identifier (optional unless it is not phone number or idNumber)

documentType

string

enum

Identification document type

externalRef

string

An external reference to tag this customer with

metadataEntries

object

Optional map of metadata entries to attach to the customer in the same call. Keys must match server-supported fields (e.g., NATIONAL_ID, STATUS, BUSINESS_NAME, BUSINESS_ADDRESS). For STATUS, allowed values: OPTED_IN, OPTED_OUT.

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Successful response

400Bad request - something wrong with the request parameters

401Not authenticated

403No permission to access the resource