Create a customer async

post

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

Create customer request and returns the request acknowledgement

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

requestReference

string

required

Your unique identifier provided in the request

callbackUrl

string

required

Your callback URL

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 async create 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

Callback

Language

Credentials

Bearer

Loading…

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

application/json

200Successful operation

400Bad request - something wrong with the request parameters

401Not authenticated

403No permission to access the resource