> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paywithsoap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# customer.kyc.created

> Event triggered when Soap creates a KYC identity record for a customer.

<Warning>
  `customer.kyc.created` is off by default. It will not be delivered until you enable it in Dashboard → Developers. See [Receiving Webhooks](/api-reference/api-v1/webhooks/setup) for instructions.
</Warning>

Fired when Soap records a KYC identity for a customer — typically after they complete identity verification in hosted checkout. It does **not** fire for identities you submit yourself via [KYC upsert](/api-reference/api-v1/kyc/upsert).

This is a customer event, not a checkout event. The payload has no `charge`, `line_items`, or `subscription` fields.

`last_four_ssn` is never included.

## Payload Structure

```typescript theme={null}
interface WebhookEvent {
  event_id: string;
  data: {
    id: string; // the KYC identity id (`id_...`)
    customer: {
      id: string;
    };
    verified: boolean;
    provider: string;
    first_name: string | null;
    last_name: string | null;
    date_of_birth: string | null;
    email: string | null;
    phone_number: string | null;
    address_line_1: string | null;
    address_line_2: string | null;
    city: string | null;
    state: string | null;
    postal_code: string | null;
    country: string | null;
    created_at: string; // ISO 8601
  };
  type: "customer.kyc.created";
}
```

Providers supply different subsets of KYC data, so most identity fields can be `null`. `id`, `customer`, `verified`, `provider`, and `created_at` are always present.

## Example Response

```json theme={null}
{
  "event_id": "ev_tDaWu5aTVa2kbvDjGe55rxZpaMEmVFWB",
  "data": {
    "id": "id_EpAugxZsSp3HPsef65tFrkdDujTr85Y6",
    "customer": {
      "id": "cus_vi57KegYgcRqcGHqip8q6UZiqtrwMT870"
    },
    "verified": true,
    "provider": "veriff",
    "first_name": "John",
    "last_name": "Doe",
    "date_of_birth": "1980-01-01",
    "email": "john.doe@example.com",
    "phone_number": "1234567890",
    "address_line_1": "123 Main St",
    "address_line_2": "Apt 4",
    "city": "Metropolis",
    "state": "NY",
    "postal_code": "12345",
    "country": "USA",
    "created_at": "2026-08-25T18:20:59Z"
  },
  "type": "customer.kyc.created"
}
```