Skip to main content
GET
List integrations
List third-party integrations connected to the current company. Encrypted access and refresh tokens are never returned by this endpoint — only the public metadata needed to display the connection state. Required scope: integrations:read. Soft-deleted (disconnected) rows are filtered out. Pass ?provider=google_calendar to filter to a specific provider. Use the status field to drive UI:
  • active — ready to use in flow tool-call nodes
  • disconnected — refresh token revoked or invalidated; the user needs to reconnect
  • error — repeated refresh failures; the bot will hit the error transition on tool-call nodes that reference this row

Authorizations

Authorization
string
header
required

Your Yappr API key (e.g. ypr_live_...). Generate one in the dashboard under Settings → API Keys.

Query Parameters

provider
enum<string>

Filter by provider.

Available options:
google_calendar,
gmail

Response

200 - application/json

Integrations list

data
object[]