List Integrations

​

Overview

• Populate an integrations gallery or dropdown
• Show which services are supported and their auth types
• Drive onboarding flows before connecting and executing features

​

Request

curl -X GET "https://api.incredible.one/v1/integrations"

​

Response

[
  {
    "id": "gmail",
    "name": "Gmail",
    "description": "Gmail integration for sending and managing emails",
    "logo_url": "https://example.com/gmail-logo.png",
    "app_url": "https://gmail.com",
    "features": [
      {
        "name": "GMAIL_SEND_EMAIL",
        "description": "Send an email via Gmail"
      }
    ],
    "auth_method": "OAUTH2"
  },
  {
    "id": "perplexity",
    "name": "Perplexity",
    "description": "AI-powered search and research tool",
    "logo_url": "https://example.com/perplexity-logo.png",
    "app_url": "https://perplexity.ai",
    "features": [
      {
        "name": "PERPLEXITY_SEARCH",
        "description": "Perform a search query"
      }
    ],
    "auth_method": "API_KEY"
  }
]

​

Field reference

• id string — Unique identifier (e.g., gmail, perplexity).
• name string — Human‑readable name.
• description string — What the integration does.
• logo_url string — URL to the app logo to display in your UI.
• app_url string — Link to the app’s homepage.
• features array — List of available features/functions; each item has:
  • name string — Feature identifier (e.g., GMAIL_SEND_EMAIL).
  • description string — What the feature does.
• auth_method string — Authentication type: OAUTH2, API_KEY, BASIC_AUTH, or NONE.

​

Error responses

{
  "error": "Unauthorized",
  "instructions": "Provide a valid API token in the Authorization header"
}

{
  "error": "Internal server error",
  "details": "Upstream provider unreachable. Try again later."
}

​

Next steps

• Get details for a specific integration: /api-reference/endpoint/get-integration
• Connect a user to an integration: /api-reference/endpoint/connect-integration
• Execute a feature: /api-reference/endpoint/execute-feature

​

All integrations