Skip to main content

Customer events (person.*)

Facts from the customer (debtor) registry. In entity events, data is the customer serialized in the customers v1 API format, with the summarized classification embedded.

person.created​

Fires when a customer is registered (dashboard, API or import).

{
  "event": "person.created",
  "timestamp": "2026-07-23T12:00:00.000Z",
  "organization_id": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
  "workspace_id": "5e8d1c4b-7a2f-4c9e-b3d6-0a1f2e3d4c5b",
  "data": {
    "id": "7c1e9f2a-3b4d-4c5e-8f6a-1b2c3d4e5f60",
    "public_id": "e4b7a1c2-9d3e-4f5a-b6c7-d8e9f0a1b2c3",
    "organization_id": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
    "workspace_id": "5e8d1c4b-7a2f-4c9e-b3d6-0a1f2e3d4c5b",
    "company_id": null,
    "classification_id": "5d8e2f4a-6b1c-4d3e-9f7a-8c5b2d4e6f1a",
    "document_number": "12345678000190",
    "document_type": "cnpj",
    "kind": "juridical",
    "name": "Padaria Pão Quente Ltda",
    "legal_name": "Pão Quente Comércio de Alimentos Ltda",
    "nickname": null,
    "birthday": null,
    "addresses": [
      {
        "street": "Rua das Flores, 123",
        "city": "São Paulo",
        "state": "SP",
        "zip_code": "01310-100",
        "label": "comercial"
      }
    ],
    "phones": [{ "number": "+5511998765432", "label": "principal", "whatsapp": true }],
    "emails": [{ "address": "financeiro@paoquente.com.br", "label": "financeiro" }],
    "external_id": "ERP-CLI-0042",
    "tags": ["varejo", "sp"],
    "notes": null,
    "custom_data": null,
    "created_via_api": true,
    "flagged_third_party_at": null,
    "metadata": {},
    "custom_metadata": null,
    "created_at": "2026-07-23T12:00:00.000Z",
    "updated_at": "2026-07-23T12:00:00.000Z",
    "deleted_at": null,
    "classification": {
      "id": "5d8e2f4a-6b1c-4d3e-9f7a-8c5b2d4e6f1a",
      "name": "Bom pagador",
      "code": "good_payer",
      "color": "#22c55e"
    }
  }
}

person.updated​

Fires when the record is changed. Same shape as person.created, with the fields already updated.

person.deleted​

Fires on (logical) deletion of the customer. data carries only the reference:

{
  "event": "person.deleted",
  "timestamp": "2026-07-23T12:00:00.000Z",
  "organization_id": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
  "workspace_id": "5e8d1c4b-7a2f-4c9e-b3d6-0a1f2e3d4c5b",
  "data": { "id": "7c1e9f2a-3b4d-4c5e-8f6a-1b2c3d4e5f60" }
}

person.classification_changed​

Fires when automatic classification moves the customer to a different category (e.g. reclassification after a payment). data carries the transition and the payment statistics that justified it:

{
  "event": "person.classification_changed",
  "timestamp": "2026-07-23T12:00:00.000Z",
  "organization_id": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
  "workspace_id": "5e8d1c4b-7a2f-4c9e-b3d6-0a1f2e3d4c5b",
  "data": {
    "person_id": "7c1e9f2a-3b4d-4c5e-8f6a-1b2c3d4e5f60",
    "previous_classification_id": "9a1b3c5d-7e2f-4a6b-8c4d-1e3f5a7b9c2d",
    "new_classification_id": "5d8e2f4a-6b1c-4d3e-9f7a-8c5b2d4e6f1a",
    "stats": {
      "total_charges": 14,
      "paid_on_time": 11,
      "paid_late": 2,
      "still_overdue": 1,
      "current_overdue_days": 12,
      "consecutive_delays": 1,
      "on_time_percentage": 78.6,
      "has_negativation_history": false,
      "has_protest_history": false
    }
  }
}

previousClassificationId and newClassificationId can be null (customer without a classification before/after).