Skip to main content
POST
/
customers
Create a customer
curl --request POST \
  --url https://pay.chargily.net/test/api/v2/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "address": {
    "country": "<string>",
    "state": "<string>",
    "address": "<string>"
  },
  "metadata": [
    {}
  ]
}
'
{
  "id": "01hj0p5s3ygy2mx1czg2wzcc4x",
  "entity": "customer",
  "livemode": false,
  "name": "Hocine Saad",
  "email": null,
  "phone": null,
  "address": {
    "country": "Algeria",
    "state": "Tizi-Ouzou",
    "address": "123 Main Street"
  },
  "metadata": null,
  "created_at": 1702977791,
  "updated_at": 1702977791
}

​
Body parameters

​
name
string
The name of the customer.
​
email
string
The email of the customer.
​
phone
string
The phone number of the customer.
​
address
object
The address of the customer
​
metadata
array
A Set of key-value pairs that can be used to store additional information about the product.

​
Returns

If the request is successful, it returns a customer object. 
{
  "id": "01hj0p5s3ygy2mx1czg2wzcc4x",
  "entity": "customer",
  "livemode": false,
  "name": "Hocine Saad",
  "email": null,
  "phone": null,
  "address": {
    "country": "Algeria",
    "state": "Tizi-Ouzou",
    "address": "123 Main Street"
  },
  "metadata": null,
  "created_at": 1702977791,
  "updated_at": 1702977791
}