---
title: "Create connection"
method: POST
path: "/v3/connections/{provider}"
tags: ["Connections"]
---

# Create connection

`POST /v3/connections/{provider}`

Initialize connection and get authorization URL

## Path parameters

- `provider` 'notion' | 'google-drive' | 'onedrive' | 'gmail' | 'github' | 'web-crawler' | 's3', required

## Request body

- object — Configuration for the connection
  - `containerTag` string
  - `containerTags` string[]
  - `documentLimit` integer
  - `metadata` object, nullable
  - `redirectUrl` string

## Response `200`

Authorization URL

- object
  - `authLink` string, required
  - `expiresIn` string, required
  - `id` string, required
  - `redirectsTo` string

## Other responses

- `401` — Unauthorized

## Changes

- **2026-03-15** `b40318167017` — 1 breaking
  - request body became required
- **2026-03-12** `7386f0fb8043` — 2 warning
  - changed the pattern of the request property `containerTag` from `^[a-zA-Z0-9_-]+$` to `^[a-zA-Z0-9_:-]+$`
  - changed the pattern of the request property `containerTags/items/` from `^[a-zA-Z0-9_-]+$` to `^[a-zA-Z0-9_:-]+$`
- **2026-03-09** `8d6903994bad` — 1 breaking, 1 warning, 1 info
  - added the pattern `^[a-zA-Z0-9_-]+$` to the request property `containerTags/items/`
  - the `containerTags/items/` request property's maxLength was set to `100`
  - added the new optional request property `containerTag`
- **2026-01-28** `228aa031e151` — 1 info
  - api operation id `postV3Connections:provider` removed and replaced with `postV3ConnectionsByProvider`
- **2026-01-09** `5265b03b27de` — 1 info
  - added the new enum value `gmail` to the `path` request parameter `provider`

[Full history](https://skmtc.dev/supermemoryai/apis/supermemory-api/changes/v3/connections/:provider/post.md)

---

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