Create customer

Production

https://api.simpra.app

POST

/apps/api/v1/customers

Create a new customer

Request

Authorization

Add parameter in header

Simpra-Access-Token

Example:

Simpra-Access-Token: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Customer created successfully

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.simpra.app/apps/api/v1/customers' \
--header 'Simpra-Access-Token: <api-key>' \
--header 'Content-Type: application\json' \
--data-raw '{
    "phone_number": "string",
    "email": "user@example.com",
    "first_name": "string",
    "last_name": "string",
    "gender": 0,
    "external_id": "string",
    "customer_discount_id": "19a13e6f-e7b9-4388-8c2b-b53e4048e42a",
    "customer_address": {
        "address": "string",
        "label": "string",
        "property_id": "05003a8a-8f3c-454b-8884-a906ec46f5f5"
    },
    "customer_invoice": {
        "name": "string",
        "company": "string",
        "tax_admin": "string",
        "tckn_or_vkn": "string",
        "address": "string",
        "email": "user@example.com",
        "description": "string"
    }
}'

Response Example

{
    "customer": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string"
    }
}

Modified at 2025-09-10 09:28:46

List customers

Update customer