Skip to main content
POST
/
customers
Create a Customer
curl --request POST \
  --url https://sandbox-api.prava.space/v1/customers \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '{
  "type": "<string>",
  "signed_agreement_id": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "birth_date": "<string>",
  "address": {
    "street_line_1": "<string>",
    "city": "<string>",
    "subdivision": "<string>",
    "postal_code": "<string>",
    "country": "<string>"
  }
}'
{
  "data": {
    "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "type": "individual",
    "status": "pending",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "created_at": "2025-10-15T05:36:43.000Z",
    "updated_at": "2025-10-15T05:36:43.000Z"
  },
  "meta": {
    "request_id": "req_12345",
    "timestamp": "2025-10-15T05:36:43.000Z",
    "idempotency_key": "ee461e0f-1808-4018-9ee1-2744a8e822f7"
  }
}

Authorizations

Api-Key
string
header
required

Headers

Idempotency-Key
string<uuid>
required

A unique key for the request to ensure idempotency.

Body

application/json
type
string
signed_agreement_id
string
first_name
string
last_name
string
email
string
phone
string
birth_date
string
address
object

Response

Customer created successfully.

The response is of type any.

I