Embedded Authentication

Example Use Case

Real-time fraud monitoring for suspicious transaction patterns or user behavior.

Request Specifications

Required API Field	Definition	Notes
`timestamp`	Timestamp of the event.
One of: `external_entity_id` `entity_token`	Unique identifier for the Entity associated with the embedded authentication.
`embedded_application`	The embedded application that the user is authenticating into.	Possible enum values: zelle, billpay

Example Request/Response

{
    "event_type": "embedded_authentication",
    "event_status": "attempted",
    "event_lifecycle_id": "7034bbbd-5da1-4f48-b82d-3edb3c7695a4",
    "data": {
        "timestamp": "2025-10-28T21:22:33.427Z",
        "external_entity_id": "94d57b2e-c516-4240-9fcc-5f96238f8c1e",
        "embedded_application": "zelle",
        "device": {
            "device_type": "mobile",
            "ip_address_v4": "81.128.112.166"
        },
        "meta": {
            "foo": "bar"
        },
        "supplemental_data": {}
    }
}

{
    "status_code": 201,
    "event_request_token": "EV-S2mN4uhUsMYeOS2aczQh",
    "_links": {
        "self": {
            "href": "/v1/events/EV-S2mN4uhUsMYeOS2aczQh"
        }
    },
    "event": {
        "event_type": "embedded_authentication",
        "event_status": "PROCESSED",
        "event_lifecycle_id": "7034bbbd-5da1-4f48-b82d-3edb3c7695a4",
        "data": {
            "timestamp": "2025-10-28T21:22:33.427Z",
            "external_entity_id": "94d57b2e-c516-4240-9fcc-5f96238f8c1e",
            "embedded_application": "zelle",
            "device": {
                "device_type": "mobile",
                "ip_address_v4": "81.128.112.166"
            },
            "meta": {
                "foo": "bar"
            },
            "supplemental_data": {},
            "entity_token": "P-9QA3PSY6r2DQb3g3X2Ux"
        },
        "evaluations": [],
        "journey_applications": []
    }
}