---
title: "Connect integration"
method: POST
path: "/api/integrations/connect"
tags: ["Platform API"]
---

# Connect integration

`POST /api/integrations/connect`

Connect a provider with direct credentials or create a browser-auth connection session.

## Request body

- IntegrationConnectRequest
  - `provider` 'hubspot' | 'attio' | 'slack' | 'fireflies' | 'granola' | 'google-calendar' | 'google-mail' | 'posthog' | 'stripe' | 'supabase' | 'clerk' | 'pylon', required — Public integration provider ID.
  - `config` object — Direct credential config. Omit to create a browser-auth connection session.

## Response `200`

Direct credential connection or browser session response.

- union
  - IntegrationDirectConnectionResponse
    - `connected` boolean, required
    - `connectionId` string, required
    - `alreadyConnected` boolean, required
  - IntegrationBrowserSessionResponse
    - `sessionId` string, required
    - `connectUrl` string, uri, required
    - `alreadyConnected` boolean, required

## Other responses

- `400` — Invalid request body or parameters.
- `401` — Invalid or missing API key.
- `403` — Plan integration connection limit reached.
- `500` — Internal server error.

---

[API](https://skmtc.dev/outlitai/apis/outlit-api.md) · [All operations](https://skmtc.dev/outlitai/apis/outlit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/outlitai/outlit-api/revisions/147173adbb3f/schema)