Skip to content
Trile Docs

Create a customer

POST
/v1/customers

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Header Parameters

Section titled “Header Parameters ”
Idempotency-Key
required
string
<= 255 characters

A client-generated unique key (UUID recommended). Required on all POST/PATCH/DELETE. Retrying with the same key returns the original response for 24 hours.

Request Body required

Section titled “Request Body required ”
object
email
required
string format: email
name
string
phone

E.164, e.g. +9779800000000.

string
metadata

Up to 50 key/value string pairs you can attach to an object. Trile ignores them; they’re returned on every read.

object
key
additional properties
string
{
  "internal_user_id": "42"
}

Responses

Section titled “ Responses ”

201

Section titled “201 ”

A customer object.

object
id
string
cus_01ARZ3NDEKTSV4RRFFQ69G5FAW
email
string format: email
name
string
phone
string
+9779800000000
metadata

Up to 50 key/value string pairs you can attach to an object. Trile ignores them; they’re returned on every read.

object
key
additional properties
string
{
  "internal_user_id": "42"
}
createdAt
string format: date-time

401

Section titled “401 ”

Missing or invalid API key.

object
success
boolean
error
object
code
string
insufficient_funds
message
string
Wallet balance is below the first cycle amount.
meta
object
requestId
string
req_aBcDeFgHiJkL

409

Section titled “409 ”

Error.

object
success
boolean
error
object
code
string
insufficient_funds
message
string
Wallet balance is below the first cycle amount.
meta
object
requestId
string
req_aBcDeFgHiJkL

422

Section titled “422 ”

Request validation failed.

object
success
boolean
error
object
code
string
insufficient_funds
message
string
Wallet balance is below the first cycle amount.
meta
object
requestId
string
req_aBcDeFgHiJkL