---
updatedAt: 2025-10-28T21:37:13.000Z
agentTools:
  projectIndex: https://developer.alloy.com/public/llms.txt
---

# Embedded Authentication

A new authentication to an embedded application (Zelle, Bill Pay) has occurred.

## Example Use Case

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

## Request Specifications

<br />

<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 associated with the embedded authentication.
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        `embedded_application`
      </td>

      <td>
        The embedded application that the user is authenticating into.
      </td>

      <td>
        Possible enum values: zelle, billpay
      </td>
    </tr>
  </tbody>
</Table>

### Example Request/Response

```json Request
{
    "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": {},
        "supplemental_data": {}
    }
}
```
```json Response
{
    "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": []
    }
}
```

<br />