add_pos_customer

Add Customer

This API endpoint makes an HTTP POST request to add a new customer. we use this end point to ad new customer in POS only customer add base on business secure key in header

Request Body

The request should include a form-data body with the following parameters

first_name (text)

last_name (text)

email (text)

phone (text)

address1 (text)

vat_number (text)

company_name (text)

currency (text)

user_type (text)

business_id (int)

customer_type (text)

longitude (text)

latitude (text)

updated_at (text)

created_at (text)

id (text)

Response

Upon successful execution, the API returns a status code of 201 and a JSON response with the following structure:

{
    "status": true,
    "message": "",
    "data": {
        "uuid": "",
        "first_name": "",
        "last_name": "",
        "email": "",
        "phone": "",
        "address1": "",
        "vat_number": null,
        "company_name": "",
        "currency": 0,
        "user_type": 0,
        "business_id": "",
        "customer_type": null,
        "longitude": null,
        "latitude": null,
        "updated_at": "",
        "created_at": "",
        "id": 0
    }
}

Example Response

{
    "status": true,
    "message": "",
    "data": {
        "uuid": "",
        "first_name": "",
        "last_name": "",
        "email": "",
        "phone": "",
        "address1": "",
        "vat_number": null,
        "company_name": "",
        "currency": 0,
        "user_type": 0,
        "business_id": "",
        "customer_type": null,
        "longitude": null,
        "latitude": null,
        "updated_at": "",
        "created_at": "",
        "id": 0
    }
}

curl --location --request POST 'https://taccounting.vodoerp.com/api/add_customer' \ --header 'secure_business_key: 14807664478836358b0.31329842' \ --form 'first_name="Ahmed"' \ --form 'last_name="Mohamed"' \ --form 'email="ahmed89@ymail.com"' \ --form 'phone="0598744634"' \ --form 'company_name="Vodo"'

{ "status": true, "message": "Customer Created", "data": { "uuid": "2439b1fe-8515-4667-a23e-4dbec6bce4cf", "first_name": "Ahmed", "last_name": "Mohamed", "email": "ahmed89@ymail.com", "phone": "0598744634", "address1": "", "vat_number": null, "company_name": "Vodo", "currency": 126, "user_type": 1, "business_id": "47", "customer_type": null, "longitude": null, "latitude": null, "updated_at": "2025-04-06T10:28:08.000000Z", "created_at": "2025-04-06T10:28:08.000000Z", "id": 41129 } }

Request

Header Params

secure_business_key

string

required

Example:

14807664478836358b0.31329842

Body Params multipart/form-data

business_id

string

optional

Example:

first_name

string

required

optional

Example:

Ahmed

last_name

string

required

optional

Example:

Mohamed

string

required

optional unique on busines level

Example:

ahmed89@ymail.com

phone

string

required

reqired unique bae on business level

Example:

0598744634

company_name

string

required

optional

Example:

Vodo

Responses

🟢201add_pos_customer

application/json

Body

status

boolean

required

message

string

required

data

object

required

uuid

string

required

first_name

string

required

last_name

string

required

string

required

phone

string

required

address1

string

required

vat_number

null

required

company_name

string

required

currency

integer

required

user_type

integer

required

business_id

string

required

customer_type

null

required

longitude

null

required

latitude

null

required

updated_at

string

required

created_at

string

required

integer

required

Add Customer#

Request Body#

Response#

Example Response#

Request

Responses

Add Customer

Request Body

Response

Example Response