---
updatedAt: 2025-10-02T13:20:46.000Z
agentTools:
  projectIndex: https://developer.alloy.com/public/llms.txt
---

# Person Updated

A person entity has been updated

## Example Use Case

An existing Customer has changed their PII and you want to screen the entire Entity profile through your Fraud and/or CIP Journey.

## Request Specifications

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Required API Field
      </th>

      <th>
        Definition
      </th>

      <th>
        Notes
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `timestamp`
      </td>

      <td>
        Timestamp of the event.
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        One of:\
        `external_entity_id`\
        `entity_token`
      </td>

      <td>
        Unique identifier for the Entity being updated.
      </td>

      <td>
        The `external_entity_id` field is immutable and cannot be changed to a different value if one is already set.  

        If not yet set, providing both an `external_entity_id` and an `entity_token` will set the provided value to the External ID of the Entity specified by the `entity_token`.
      </td>
    </tr>
  </tbody>
</Table>

Example Request/Response:

```json Request
{
  "event_type": "person_updated",
  "event_status": "pending",
  "event_lifecycle_id": "X12-43jf-8743jkfdsa",
  "data": {
    "external_entity_id": "cf88a0a1-34d6-492d-b617-c8b43785e7b7",
    "timestamp": "2024-03-25T22:28:42.692Z",
    "emails": [
      {
        "email_address": "example@alloy.com"
      }
    ],
    "phones": [
      {
        "phone_number": "+1934428189"
      }
    ],
    "name_first": "NewFirstName",
    "addresses": [
      {
        "line_1": "41 E 11th St",
        "line_2": "Floor 2",
        "city": "New York",
        "state": "NY",
        "postal_code": "10002",
        "country_code": "US",
        "type": "primary"
      }
    ],
        "meta": {},
    "supplemental_data": {}
  }
}

```
```json Response
{
    "status_code": 201,
    "event_request_token": "EV-0TzoUqB3PL2dxl3FgOAz",
    "_links": {
        "self": {
            "href": "/v1/events/EV-0TzoUqB3PL2dxl3FgOAz"
        }
    },
    "event": {
        "event_type": "person_updated",
        "event_status": "PROCESSED",
        "data": {
            "entity_token": "P-TfkFe6lCPkElc9Xktd3V",
            "external_entity_id": "cf88a0a1-34d6-492d-b617-c8b43785e7b7",
            "created_at": 1711405410009,
            "person_details_updated_at": 1711405734899,
            "gender": null,
            "birth_date": "*********",
            "name_first": "NewFirstName",
            "name_middle": null,
            "name_last": "Doe",
            "document_ssn": "*********",
            "document_license": null,
            "document_passport": null,
            "addresses": [
                {
                    "line_1": "41 E 11th St",
                    "line_2": "Floor 2",
                    "city": "New York",
                    "state": "NY",
                    "postal_code": "10002",
                    "created_at": 1711405734899,
                    "type": "primary",
                    "evaluation_token": null
                },
                {
                    "line_1": "123 Allen St",
                    "line_2": "Apt 7",
                    "city": "New York",
                    "state": "NY",
                    "postal_code": "10002",
                    "created_at": 1711405409394,
                    "type": "primary",
                    "evaluation_token": null
                }
            ],
            "emails": [
                {
                    "email_address": "example@alloy.com"
                }
            ],
            "phones": [
                {
                    "phone_number": "+1937074322"
                }
            ],
            "type": "person",
            "_embedded": {
                "document_ssns": [
                    {
                        "document_ssn": "*********",
                        "created_at": 1711405409394
                    }
                ],
                "birth_dates": [
                    {
                        "birth_date": "*********",
                        "created_at": 1711405409394
                    }
                ]
            },
            "_links": {
                "self": {
                    "href": "/v1/entities/persons/P-TfkFe6lCPkElc9Xktd3V"
                }
            }
        },
        "evaluations": [],
        "journey_applications": []
    }
}
```