External Account Created

Example Use Case

Monitoring for potential account takeover by tracking associated external accounts.

Request Specifications

Required API Field	Definition	Notes
`timestamp`	Timestamp of the event.
`external_account_id`	Unique identifier for the External Account being created.
`link_timestamp`	Timestamp when the External Account was linked.	May be the same value as `timestamp`, but both fields must be populated to differentiate between linking and unlinking.
At least one of: `entities[]`	Array of Entities that are associated with the External Account.	For each entity, either `external_entity_id` or `entity_token` is required.
One of: `external_entity_id` `entity_token`	Unique identifier of one of the Entities associated with the External Account.	Not strictly required if the event is not being monitored, but recommended to include for future proofing your integration. This field has no impact on which Entities are attached to the Account, although it should match at least one of the Entities that the Account belongs to.

Example Request/Response:

{
    "event_type": "external_account_created",
    "event_status": "pending",
    "event_lifecycle_id": "X99-43jf-74382",
    "data": {
        "external_account_id": "a58babe2-3f11-4bc5-8d2e-53df918a0a4b",
        "external_entity_id": "9e82d5e7-ada0-4957-a8fd-4d937c99bae8",
        "timestamp": "2024-03-28T02:16:26.983Z",
        "account_name": "PLAID BOA #1927462",
        "account_number": "0123456",
        "routing_number": "021000021",
        "link_timestamp": "2024-03-28T02:16:26.983Z",
        "entities": [{
            "external_entity_id": "9e82d5e7-ada0-4957-a8fd-4d937c99bae8",
            "account_holder_type": "primary"
        }],
        "supplemental_data": {}
    }
}

{
    "status_code": 201,
    "event_request_token": "EV-71dGopCrgQhIuYhAQL6P",
    "_links": {
        "self": {
            "href": "/v1/events/EV-71dGopCrgQhIuYhAQL6P"
        }
    },
    "event": {
        "event_type": "external_account_created",
        "event_status": "PROCESSED",
        "data": {
            "account_name": "PLAID BOA #1927462",
            "account_number": "0123456",
            "routing_number": "021000021",
            "is_linked_account": true,
            "link_timestamp": "2024-03-28T02:16:26.983Z",
            "entities": [
                {
                    "entity_token": "P-TfkFe6lCPkElc9Xktd3V",
                    "external_entity_id": "9e82d5e7-ada0-4957-a8fd-4d937c99bae8",
                    "account_holder_type": "primary"
                }
            ],
            "external_account_id": "a58babe2-3f11-4bc5-8d2e-53df918a0a4b",
            "external_entity_id": "9e82d5e7-ada0-4957-a8fd-4d937c99bae8",
            "account_token": "A-Ca2ecg6Rt1rN75wcsECt"
        },
        "evaluations": [],
        "journey_applications": []
    }
}