---
title: "Webhook event: customer.event.v1"
method: POST
path: "customer.event.v1"
---

# Webhook event: customer.event.v1

`POST customer.event.v1` (webhook)

Triggered when there are important updates to a customer's profile or status. This includes changes in verification status, updated compliance checks, modified risk ratings, or changes to customer information.

## Payload

- object
  - `event_type` string, required — Type of the event
  - `event_id` string, uuid, required — UUID of the event
  - `account_id` string, uuid, required — UUID of the account associated with this event
  - `data` CustomerEventV1, required
    - `id` string, uuid, required — Unique identifier for the customer.
    - `address` AddressEventV1
      - `address1` string, required — Primary address line (e.g., street, PO Box).
      - `address2` string, nullable — Secondary address line (e.g., apartment, suite, unit, or building).
      - `city` string, required — City, district, suburb, town, or village.
      - `state` string, required — Two-letter state code.
      - `zip` string, required — Zip or postal code.
    - `compliance_profile` ComplianceProfileEventV1
      - `dob` string, ****-**-**, nullable — Date of birth for individual customers in ISO 8601 format (YYYY-MM-DD). This data is required to trigger Patriot Act compliant Know Your Customer (KYC) verification. Required if SSN is provided. Only valid where customer type is 'individual'.
      - `ssn` string, ***-**-****, nullable — Full 9-digit Social Security Number or government identifier for individuals. This data is required to trigger Patriot Act compliant KYC verification. Required if DOB is provided. Only valid where customer type is 'individual'.
      - `ein` string, **-*******, nullable — Full 9-digit Employer Identification Number for businesses. This data is required to trigger Patriot Act compliant Know Your Business (KYB) verification. Only valid where customer type is 'business'.
      - `legal_business_name` string, nullable — The official name of the business. This name should be correlated with the ein value. Only valid where customer type is 'business'.
      - `website` string, nullable — URL of the company's official website. Only valid where customer type is 'business'.
    - `device` DeviceEventV1, required
      - `ip_address` string, required — The customer's IP address at the time of profile creation. Use '0.0.0.0' to represent an offline customer registration.
    - `name` string, required — Full name of the individual or business name.
    - `type` 'individual' | 'business', required
    - `email` string, required — The customer's email address.
    - `phone` string, required — The customer's phone number in E.164 format.
    - `external_id` string, nullable — Unique identifier for the customer in your database, used for cross-referencing between Straddle and your systems.
    - `status` 'pending' | 'review' | 'verified' | 'inactive' | 'rejected', required
    - `created_at` string, date-time, required — Timestamp of when the customer record was created.
    - `updated_at` string, date-time, required — Timestamp of the most recent update to the customer record.
    - `metadata` object, nullable — Up to 20 additional user-defined key-value pairs. Useful for storing additional information about the customer in a structured format.

## Acknowledgement `200`

Webhook processed successfully

---

[API](https://skmtc.net/straddleio/apis/straddle-api.md) · [All operations](https://skmtc.net/straddleio/apis/straddle-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/straddleio/straddle-api/revisions/6e13cd88cda9/schema)