1. v1
Tourwell Open APIs
  • Tổng quan
  • Hướng dẫn xác thực
  • API Zalo Mini App (Beta)
  • API Changelog
  • Error Response
  • Khách hàng
    • v1
      • Get by id
        GET
      • Get all customer
        GET
      • Create customer
        POST
      • Update customer
        PUT
      • Get order history
        GET
      • Get destinations
        GET
      • Get guests
        GET
      • Get by id care history
        GET
      • Create company
        POST
      • Get all care history
        GET
  • Đơn hàng
    • v1
      • Get by id
      • Get all order
      • Get Passengers Order
      • Create order tour
      • Create order product
      • Create order hotel
      • Create order flight
      • Confirm payment order
      • Cancel order
      • Import Order Flight
      • Create cost order
      • Update cost order
      • Delete cost order
  • Điều hành
    • v1
      • Overview
      • Create row cost
      • Update row cost
      • Delete row cost
  • Sản phẩm
    • v1
      • Create product
      • Get by id
      • Calendar pricing
      • Get all product
      • Get schedule by id
      • Update product
  • Chiết tinh giá
    • v1
  • Nhà cung cấp
    • v1
      • Get all suppliers
      • Get suppliers products
      • Get all tour guides
      • Create Supplier & Hotel
      • Create Prices Suppliers products
      • Append Prices Hotel
  • Lịch khởi hành
    • v1
      • Get all tour
      • Create tour
  • Lead (Cơ hội)
    • Overview
    • Update History
    • v1
      • Get all lead
      • Get by id
      • Create lead
      • Update lead
  • Báo giá
    • v1
      • Get all
      • Update schedules
      • Update policy
  • Khách sạn
    • v1
      • Get all hotel
      • Get by id
  • Kế toán
    • Phiếu thu
      • v1
        • Get all receipt
        • Create receipt
        • Update receipt
        • Confirm Receipt Success
    • Phiếu chi
      • v1
        • Get all payment
        • Confirm Payment
    • Hóa đơn bán ra
      • Update invoice
      • Issue Invoice
      • Get by id
      • Cancel invoice
    • Hóa đơn mua vào
      • Import
  • Phê duyệt
    • v1
      • Overview
      • Summary
      • Approvals
  • Cấu hình
    • Zalo ZNS
      • Danh sách Tag
      • Get token
    • Địa điểm
      • Search
    • Nhân sự nội bộ
      • Search
    • Webhook
      • Hướng dẫn cài đặt
    • Trạng thái khách hàng
      • Get All
    • Hạng thành viên
      • Get All
    • Loại dịch vụ
    • Mã sân bay
      • Get All Airport
    • Phương thức thanh toán
      • Get All
    • Nguồn bán hàng
      • Get All
    • Phễu chuyển đổi lead
      • Trạng thái lead
      • Trạng thái báo giá
  • Hướng dẫn tích hợp
    • Hướng dẫn tích hợp thanh toán trực tuyến qua Website và Tourwell
    • Hướng dẫn tích hợp thanh toán trực tuyến qua Website, Cổng thanh toán và Tourwell
  1. v1

Create customer

POST
/api/v1/customers

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Example
{
    "pronoun": "Chị",
    "name": "Thân Thị Cẩm Lệ",
    "phone": "0888899008",
    "phone_sec": "0912345678",
    "email": "",
    "email_sec": "",
    "country_code": "+84",
    "sub_group": "personal",
    "membership_tier_id": 1,
    "company_id": 123,
    "creator_email": "admin@yourdomain.com",
    "sales_email": "kd2@upwell.vn",
    "type_id": "1",
    "source_id": "1",
    "birthday": "01/01/1990",
    "identification": "123456789",
    "passport": "B12345678",
    "address": "123 Lý Thường Kiệt, Quận 10, TP.HCM",
    "agent_level_id": 2,
    "facebook_link": "",
    "facebook_name": "Cẩm Lệ",
    "gender": "female"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://demo.tourwell.net/api/v1/customers' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "pronoun": "Chị",
    "name": "Thân Thị Cẩm Lệ",
    "phone": "0888899008",
    "phone_sec": "0912345678",
    "email": "",
    "email_sec": "",
    "country_code": "+84",
    "sub_group": "personal",
    "membership_tier_id": 1,
    "company_id": 123,
    "creator_email": "admin@yourdomain.com",
    "sales_email": "kd2@upwell.vn",
    "type_id": "1",
    "source_id": "1",
    "birthday": "01/01/1990",
    "identification": "123456789",
    "passport": "B12345678",
    "address": "123 Lý Thường Kiệt, Quận 10, TP.HCM",
    "agent_level_id": 2,
    "facebook_link": "",
    "facebook_name": "Cẩm Lệ",
    "gender": "female"
}'

Responses

🟢201Created
application/json
Bodyapplication/json

Example
{"success":true,"message":"The customer created successfully","data":{"id":2150,"name":"Thân Thị Cẩm Lệ","code":"KH2150","link_erp":"http://{{host}}/admin/customer/2150/show"}}
Modified at 2026-06-08 15:24:48
Previous
Get all customer
Next
Update customer
Built with