# EXTERNAL_AUTH_CONNECTED

- **URL:** https://marketplace.gohighlevel.com/docs/webhook/ExternalAuthConnected
- **Summary:** Called whenever external authentication (OAuth2 or Basic) is connected successfully for an app/location/company.

[Skip to main content](https://marketplace.gohighlevel.com/docs/webhook/ExternalAuthConnected#__docusaurus_skipToContent_fallback)

Version: v3

On this page

Called whenever external authentication (OAuth2 or Basic) is connected successfully for an app/location/company.

#### Schema[​](https://marketplace.gohighlevel.com/docs/webhook/ExternalAuthConnected#schema "Direct link to Schema")

    {  "type": "object",  "properties": {    "type": { "type": "string", "enum": ["EXTERNAL_AUTH_CONNECTED"] },    "appId": { "type": "string" },    "locationId": { "type": "string" },    "companyId": { "type": "string" },    "authType": { "type": "string", "enum": ["oauth2", "basic"] },    "scopes": { "type": "string" },    "isAutoRefreshTokenEnabled": { "type": "boolean" },    "timestamp": { "type": "string", "format": "date-time" },    "webhookId": { "type": "string" }  },  "required": ["type", "appId", "locationId", "companyId", "authType", "timestamp", "webhookId"]}

*   Note: `scopes` and `isAutoRefreshTokenEnabled` are present only for OAuth2 connections.

#### Example[​](https://marketplace.gohighlevel.com/docs/webhook/ExternalAuthConnected#example "Direct link to Example")

*   For OAuth2 External Auth Connection

    {  "type": "EXTERNAL_AUTH_CONNECTED",  "appId": "6800a826637cd0457e0d11e1",  "locationId": "76sPakGvkoG3WyTyZkhk",  "companyId": "zzyG7A4x6bRJl5SlhQhH",  "authType": "oauth2",  "scopes": "crm.objects.contacts.write crm.schemas.contacts.write oauth crm.schemas.contacts.read crm.objects.contacts.read",  "isAutoRefreshTokenEnabled": true,  "timestamp": "2025-05-19T12:48:50.972Z",  "webhookId": "42f1d489-dc91-4749-a2a2-8c441989a3b5"}

*   For Basic Auth External Auth Connection

    {  "type": "EXTERNAL_AUTH_CONNECTED",  "appId": "66e96b579245705d69e5ba6a",  "locationId": "76sPakGvkoG3WyTyZkhk",  "companyId": "zzyG7A4x6bRJl5SlhQhH",  "authType": "basic",  "timestamp": "2025-05-19T15:40:36.811Z",  "webhookId": "3b12bbc1-0be0-4678-aa76-771e88d27423"}

*   Note: The payload always includes `type`, `appId`, `locationId`, `companyId`, `authType`, `timestamp`, and `webhookId`. For OAuth2, `scopes` and `isAutoRefreshTokenEnabled` are also included.

Share your feedback
-------------------

★★★★★