---
title: "Get connection (by provider)"
method: POST
path: "/v3/connections/{provider}/connection"
tags: ["Connections"]
---

# Get connection (by provider)

`POST /v3/connections/{provider}/connection`

Get connection details with provider and container tags

## Path parameters

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

## Request body

- object
  - `containerTags` string[], required — Comma-separated list of container tags to filter connection by

## Response `200`

Connection details

- object
  - `createdAt` string, datetime, required
  - `documentLimit` number
  - `email` string
  - `expiresAt` string, datetime
  - `id` string, required
  - `metadata` object
  - `provider` string, required
  - `containerTags` string[]
  - `lastSyncRun` object
    - `status` string, required
    - `errorCode` 'auth_expired' | 'rate_limited' | 'plan_required' | 'provider_unavailable' | 'internal', nullable
    - `error` string, nullable
    - `startedAt` string, datetime
    - `completedAt` string, datetime

## Other responses

- `401` — Unauthorized
- `404` — Connection not found
- `500` — Internal server error

## Changes

> 8 revisions in range; 4 could not be searched.

- **2026-07-26** `9a2008ad4ee5` — 1 info
  - added the optional property `lastSyncRun` to the response with the `200` status

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

---

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