Skip to main content

Create customer

Method POST​

https://my.easyweek.io/api/public/v2/customers

Description: This endpoint creates a customer in the workspace. The phone number is normalized to E.164 using the workspace's country. A phone or email already used by another customer in the workspace is rejected.

Example Request​

curl -i -X POST \
  https://my.easyweek.io/api/public/v2/customers \
  -H 'Authorization: Bearer <YOUR_SECRET>' \
  -H 'Workspace: <YOUR_WORKSPACE>'

Request body​

{
  "phone": "+12025550111",
  "first_name": "Jane",
  "last_name": "Doe",
  "middle_name": null,
  "email": "jane@example.com",
  "birthday": "1990-05-01",
  "comment": "VIP client",
  "is_business": true,
  "company_name": "Acme Inc.",
  "vat_number": "VAT123456",
  "telegram": "@jane",
  "viber": "+12025550111",
  "whatsapp": "+12025550111"
}

Body Parameters​

  • phone (string, required): The customer's phone number. Normalized to E.164 using the workspace country.
  • first_name (string, required): The customer's first name.
  • last_name (string, optional): The customer's last name.
  • middle_name (string, optional): The customer's middle name.
  • email (string, optional): The customer's email address.
  • birthday (string, optional): The customer's date of birth in Y-m-d format.
  • comment (string, optional): A free-text note about the customer.
  • is_business (boolean, optional): Whether the customer is a business.
  • company_name (string, optional): The business name. Required when is_business is true.
  • vat_number (string, optional): The business VAT number.
  • telegram (string, optional): The customer's Telegram handle.
  • viber (string, optional): The customer's Viber contact.
  • whatsapp (string, optional): The customer's WhatsApp contact.

Example Response​

{
  "uuid": "b6d6a1f2-6f1e-4a2b-9a2c-1f2e3d4c5b6a",
  "first_name": "Jane",
  "last_name": "Doe",
  "middle_name": null,
  "phone": "+12025550111",
  "email": "jane@example.com",
  "birthday": "1990-05-01",
  "comment": "VIP client",
  "is_business": true,
  "company_name": "Acme Inc.",
  "vat_number": "VAT123456",
  "telegram": "@jane",
  "viber": "+12025550111",
  "whatsapp": "+12025550111",
  "created_at": "2026-07-16T09:00:00Z",
  "updated_at": "2026-07-16T09:00:00Z"
}