> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# External Auth Connected | Webhook Events

> Fires when a user successfully connects an external authentication provider to your app.

The `ExternalAuthConnected` event fires whenever a user successfully authenticates and connects an external provider to your app within the HoopAI platform. It identifies the app, the location or company context, and the user who performed the connection. Use this event to initialize third-party service integrations, store provider tokens, or trigger onboarding steps that depend on external auth being in place.

## Payload

| Field        | Type     | Description                                               |
| ------------ | -------- | --------------------------------------------------------- |
| `type`       | `string` | Always `"EXTERNAL_AUTH_CONNECTED"`                        |
| `appId`      | `string` | ID of the app the external auth was connected to          |
| `locationId` | `string` | Account ID where the connection was made                  |
| `companyId`  | `string` | Company ID associated with the account                    |
| `userId`     | `string` | ID of the user who performed the external auth connection |

## Example payload

```json theme={null}
{
  "type": "EXTERNAL_AUTH_CONNECTED",
  "appId": "ve9EPM428h8vShlRW1KT",
  "locationId": "otg8dTQqGLh3Q6iQI55w",
  "companyId": "otg8dTQqGLh3Q6iQI55w",
  "userId": "otg8dTQqGLh3Q6iQI55w"
}
```

## Related

* [App Install](/api-reference/webhooks/app-install) — fires when your app is installed, which often precedes an external auth connection
* [OAuth 2.0](/api-reference/oauth/overview) — authorization flow used during app and provider connections