> 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.

# Customer Status Updated Event

POST 

Sent when a customer's status changes to Active or Inactive. For instance, when a Customer is first created it will have a status of "Inactive" until the required documents have been uploaded and checked. A change of status could also be the result of a modification to existing data. For instance, a Contact could upload a new Proof of Identity document, which would cause their status to become "Inactive" until the document has been reviewed.

Once you have subscribed to the "CUSTOMER STATUS" event type, Redpin will call your designated API endpoint with the payloads described below when there is an update to one of your Customer's Statuses.

**Active Customer Example:**

```json
{
  "customer_id": "0201000005926289",
  "status": "active",
  "unique_identifier": "2df806d1-028f-405e-8a53-332b7b039d7b",
  "contacts": [
    {
      "contact_id": "4349165556",
      "first_name": "Saurabh",
      "middle_name": "Rajendra",
      "last_name": "Sarcar",
      "status": "active"
    }
  ]
}
```

**Inactive Customer Example:**

```json
{
  "customer_id": "0201000005926289",
  "status": "inactive",
  "unique_identifier": "a8509765-a76d-4c20-9ebf-c2b0f08ab187",
  "reason_for_inactive": "Identity document",
  "documents_required": [
    {
      "document_type": "POI",
      "uri": "/v1/customers/0201000005926289/contacts/4349165556/documents/0011q00000DA0MfAAL-0011q00000ab0xdf46"
    }
  ],
  "contacts": [
    {
      "contact_id": "4349165556",
      "first_name": "Saurabh",
      "middle_name": "Rajendra",
      "last_name": "Sarcar",
      "status": "active",
      "documents_required": [
        {
          "document_type": "POI",
          "uri": "/v1/customers/0201000005926289/contacts/4349165556/documents/0011q00000DA0MfAAL-0011q00000ab0xdf46"
        }
      ]
    }
  ]
}
```

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

## Request

### Payload

- `customer_id` (string, required) — Unique identifier for the customer
- `status` (enum, required) — Whether the customer is active or inactive
  - Allowed values: `active`, `inactive`
- `unique_identifier` (string, required) — When the customer is active, this is the Unique ID for this Customer provided by the `Register a Customer` operation. When inactive, this is a temporary identifier for tracking the status change.
- `contacts` (list of ContactStatus, required) — Array of contacts associated with the customer
- `customer_type` (string, optional) — Registering customer type
- `reason_for_inactive` (string, optional) — When the customer is inactive, this will be the reason for it being inactive. Only present when status is "inactive".
- `documents_required` (list of DocumentRequired, optional) — When there are outstanding documents for a Customer, this is an array of document objects. Only present when status is "inactive".

## Types

### ContactStatus

- `contact_id` (string, required) — Unique ID for this contact
- `first_name` (string, required) — First name of this contact person
- `last_name` (string, required) — Last name of this contact person
- `status` (enum, required) — Whether the Contact is active or inactive
  - Allowed values: `active`, `inactive`
- `middle_name` (string, optional) — Middle name of this contact person
- `documents_required` (list of DocumentRequired, optional) — When there are outstanding documents for a Contact, this is an array of document objects. Only present when contact status is "inactive".

### DocumentRequired

- `document_type` (enum, required) — Type of document required. - POI: Proof-of-Identity - POA: Proof-of-Address
  - Allowed values: `POI`, `POA`
- `uri` (string, required) — URI to call when sending the document back to Redpin. This endpoint should be used to upload the required document.