---
title: "Client Event"
method: POST
path: "ClientEvent"
tags: ["Webhooks"]
---

# Client Event

`POST ClientEvent` (webhook)

Sent when a client is created, updated, or deleted. The `data` field contains the full client profile with all default includes.

## Payload

- object
  - `company_id` integer, required — Location ID where the event occurred.
  - `resource` 'client', required — Resource type.
  - `resource_id` integer, required — ID of the resource that was created, updated, or deleted.
  - `status` 'create' | 'update' | 'delete', required — Type of change that occurred.
  - `data` Client, required — Client data sent in webhook notifications. Uses the full client profile with all default includes (email, card, birth_date, comment, discount, visits, sex, sms preferences, money, importance, categories, custom_fields).
    - `id` integer — Client ID.
    - `name` string — First name.
    - `surname` string
    - `patronymic` string
    - `display_name` string — Formatted full name.
    - `phone` string — Phone number (visible — webhook always has full access).
    - `email` string
    - `card` string — Loyalty card number.
    - `birth_date` string, date — Birthday in YYYY-MM-DD format.
    - `comment` string — Client card comment.
    - `discount` number — Personal discount percentage.
    - `visits` integer — Total visit count.
    - `sex_id` 0 | 1 | 2 — 0 — unknown, 1 — male, 2 — female.
    - `sex` string
    - `sms_check` 0 | 1
    - `sms_bot` 0 | 1
    - `sms_not` 0 | 1
    - `spent` number — Total amount spent.
    - `paid` number — Total amount paid.
    - `balance` number — Current balance.
    - `importance_id` integer — 0 — normal, 1 — VIP, 2 — blacklisted.
    - `importance` string
    - `categories` object[] — Client category labels.
      - `id` integer
      - `title` string
      - `color` string
    - `last_change_date` string, date-time
    - `custom_fields` object[] — Custom field values configured for this location.

## Acknowledgement `200`

Your server should return any 2xx status code to acknowledge receipt.

---

[API](https://skmtc.dev/alteg/apis/developer-tools.md) · [All operations](https://skmtc.dev/alteg/apis/developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alteg/developer-tools/revisions/c89b6494ffd2/schema)