Skip to main content
GET
/
v1
/
settings
/
providers
List Connected Providers
curl --request GET \
  --url https://api.example.com/v1/settings/providers
{
  "data": {
    "providers": [
      {
        "category": "<string>",
        "name": "<string>",
        "connected": true,
        "account_id": "<string>",
        "display_name": "<string>",
        "scopes": [
          {}
        ],
        "connected_at": "<string>",
        "last_sync_at": "<string>",
        "status": "<string>",
        "error_message": "<string>"
      }
    ]
  }
}

Request

Use this endpoint to surface integration status to your UI or health checks. It aggregates email, calendar, messaging, and identity providers into a single view.

Query Parameters

category
string
Optional filter: email, calendar, channels, identity, storage, billing.

Headers

Authorization: Bearer wbk_your_api_key_here

Response

data
object
Responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and X-Request-ID.
curl https://data.leadlex.com/functions/v1/api-gateway/v1/settings/providers \
  -H "Authorization: Bearer wbk_your_api_key_here"

Example Response

{
  "data": {
    "providers": [
      {
        "category": "email",
        "name": "gmail",
        "connected": true,
        "account_id": "team@emasex.de",
        "display_name": "Team Mailbox",
        "scopes": ["gmail.readonly", "gmail.send"],
        "connected_at": "2026-02-11T09:00:00Z",
        "last_sync_at": "2026-04-17T10:30:00Z",
        "status": "healthy",
        "error_message": null
      },
      {
        "category": "calendar",
        "name": "google",
        "connected": true,
        "account_id": "team@emasex.de",
        "display_name": "Team Calendar",
        "scopes": ["calendar.readonly"],
        "connected_at": "2026-02-11T09:00:00Z",
        "last_sync_at": "2026-04-17T10:30:00Z",
        "status": "healthy",
        "error_message": null
      },
      {
        "category": "channels",
        "name": "slack",
        "connected": true,
        "account_id": "T01234567",
        "display_name": "LeadLex Eng",
        "scopes": ["chat:write", "channels:history"],
        "connected_at": "2026-02-20T14:00:00Z",
        "last_sync_at": "2026-04-17T10:30:00Z",
        "status": "healthy",
        "error_message": null
      }
    ]
  }
}

Errors

StatusCodeDescription
401invalid_keyInvalid or expired API key
403insufficient_permissionsMissing read:settings permission
429rate_limitedRate limit exceeded