Create a customer
Creates a new customer record and automatically initiates identity, fraud, and risk assessment scores. This endpoint allows you to create a customer profile and associate it with paykeys and payments.
Authorizations
Use your Straddle API Key in the Authorization header as Bearer <token> to authorize API requests.
Headers
For use by platforms to specify an account id and set scope of a request.
Optional client generated identifier to trace and debug a request.
Optional client generated identifier to trace and debug a series of requests.
Body
The customer's email address.
Full name of the individual or business name.
The customer's phone number in E.164 format. Mobile number is preferred.
individual
, business
An object containing the customer's address. This is optional, but if provided, all required fields must be present.
An object containing the customer's compliance profile. This is optional, but if provided, all required fields must be present for the appropriate customer type.
Unique identifier for the customer in your database, used for cross-referencing between Straddle and your systems.
Up to 20 additional user-defined key-value pairs. Useful for storing additional information about the customer in a structured format.
Response
Metadata about the API request, including an identifier and timestamp.
Indicates the structure of the returned content.
- "object" means the
data
field contains a single JSON object. - "array" means the
data
field contains an array of objects. - "error" means the
data
field contains an error object with details of the issue. - "none" means no data is returned.
object
, array
, error
, none