> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.redpincompany.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.redpincompany.com/_mcp/server.

# Third Party Customer Status Updated Event

POST 

Sent when a third party customer's compliance status changes to `APPROVED`, `REJECTED`, or `PENDING`. Subscribe to the `THIRD PARTY CUSTOMER STATUS` event type to receive these updates.

The `data` object contains `customer_id`, `client_customer_ref`, and `status`. When the status is `REJECTED`, a `reasons` array is included with machine-readable codes and human-readable descriptions.

**Example payloads:**

```json
{
  "event_id": "1",
  "event_type": "THIRD PARTY CUSTOMER STATUS",
  "version": "v1.0.0",
  "event_timestamp": "2025-01-01T00:00:00Z",
  "data": {
    "customer_id": "0201001008132685",
    "client_customer_ref": "CUST_001",
    "status": "REJECTED",
    "reasons": [
      {
        "reason": "Compliance check failed due to validation or regulatory issues",
        "code": "COMPLIANCE_CHECK_FAILED"
      }
    ]
  }
}
```

```json
{
  "event_id": "3",
  "event_type": "THIRD PARTY CUSTOMER STATUS",
  "version": "v1.0.0",
  "event_timestamp": "2025-01-01T00:00:00Z",
  "data": {
    "customer_id": "0201001008132685",
    "client_customer_ref": "CUST_001",
    "status": "APPROVED"
  }
}
```

```json
{
  "event_id": "2",
  "event_type": "THIRD PARTY CUSTOMER STATUS",
  "version": "v1.0.0",
  "event_timestamp": "2025-01-01T00:00:00Z",
  "data": {
    "customer_id": "0201001008132685",
    "client_customer_ref": "CUST_001",
    "status": "PENDING"
  }
}
```

Reference: https://docs.redpincompany.com/api-reference/webhooks/third-party-customers/webhook-third-party-customer-status-updated

## Request

### Payload

- `event_id` (string, required) — Unique identifier for the event
- `event_type` (enum, required) — Type of webhook event. Always "THIRD PARTY CUSTOMER STATUS" for third party customer status events.
  - Allowed values: `THIRD PARTY CUSTOMER STATUS`
- `version` (string, required) — Payload version. Currently "v1.0.0". This enables controlled evolution of the webhook contract.
- `event_timestamp` (datetime, required) — Timestamp of the event in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).
- `data` (ThirdPartyCustomerStatusEventData, required) — Business data for the third party customer status event. Contains customer and status information. The `reasons` field is only present when the status is `REJECTED`.

## Types

### ThirdPartyCustomerStatusEventData

Business data for the third party customer status event. Contains customer and status information. The `reasons` field is only present when the status is `REJECTED`.

- `customer_id` (string, required) — Unique identifier for the customer
- `client_customer_ref` (string, required) — The unique reference identifier of the third party client
- `status` (enum, required) — Status of the third party customer
  - Allowed values: `REJECTED`, `APPROVED`, `PENDING`
- `reasons` (list of ThirdPartyCustomerStatusEventDataReasonsItems, optional) — Array of reasons for rejection (only present when status is REJECTED).

### ThirdPartyCustomerStatusEventDataReasonsItems

- `reason` (string, required) — Human-readable reason for the status
- `code` (enum, required) — Machine-readable code for the reason
  - Allowed values: `COMPLIANCE_CHECK_FAILED`