Add Customer

Production

https://api.simpra.app

POST

/apps/api/v1/customers

Last modified:2026-07-30 09:20:57

Scope: Enterprise

Body Parameters

Parameter	Description	Required
phone_number	customer phone_number	REQUIRED
email	customer email
first_name	customer first name
last_name	customer last name
gender	customer gender
external_id	customer external id
customer_discount_id	customer discount id
customer_address.address	customer adress	REQUIRED
customer_address.label	customer adress label
customer_address.property_id	customer adress
customer_invoice.name	customer invoice name	REQUIRED
customer_invoice.company	customer invoice company	REQUIRED
customer_invoice.tax_admin	customer invoice tax admin	REQUIRED
customer_invoice.tckn_or_vkn	customer invoice tckn or vkn	REQUIRED
customer_invoice.company	customer invoice company	REQUIRED
customer_invoice.address	customer invoice address
customer_invoice.email	customer invoice email
customer_invoice.description	customer invoice description

Request

Authorization

Add parameter in header

Simpra-Access-Token

Example:

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

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.simpra.app/apps/api/v1/customers' \
--header 'Simpra-Access-Token: <api-key>' \
--header 'Content-Type: application\json' \
--data-raw '{
    "email": "hildred@muller.co",
    "first_name": "Noriko",
    "last_name": "Ebert",
    "phone_number": "1569714718",
    "gender": 1,
    "external_id": "6f6fc0e2",
    "customer_discount_id": "ac5cbc53-d295-4c93-ba75-a6229a49b8cc",
    "customer_address": {
        "address": "81412 Hane Trace",
        "label": "West Wadeville",
        "property_id": "ea6750f3-6f72-4f19-8564-5c73db0153d0"
    },
    "customer_invoice": {
        "company": "Rippin and Sons",
        "tax_admin": "Bobby Abshire",
        "tckn_or_vkn": "4799967681",
        "name": "Ms. Ignacia Ziemann",
        "address": "Apt. 545 2122 Ruecker Pines, Jerdeview, VA 68855-0750",
        "email": "gavin@gottlieb.biz",
        "description": "Perferendis sed non. Dignissimos non ipsa. Et quos velit."
    }
}'

Response Example

{
    "customer": {
        "id": "a1e1cce8-5cc6-4fbb-aec0-5539962db183",
        "name": "Noriko Ebert"
    }
}

Modified at 2026-07-30 09:20:57

Get Customers

Update Customer