---
title: "Create a connection"
method: POST
path: "/connections"
tags: ["Connections"]
---

# Create a connection

`POST /connections`

## Request

- Base URL: `https://workflow.loopfour.ai/api/v1`
- URL: `https://workflow.loopfour.ai/api/v1/connections`
- Auth: API key in header `x-api-key`

Initiates a new OAuth connection for a provider.

## Request body

- object
  - `provider` string, required: Provider integration ID.
  - `name` string: Display name for the connection.
  - `metadata` object: Additional metadata.
  - `connectionConfig` object: Provider-specific config.
  - `isDefault` boolean: Set as default for the provider.

## Response `201`

Connection initiated

- object
  - `success` unknown
  - `data` object
    - `id` string
    - `name` string
    - `provider` string
    - `status` string
    - `isDefault` boolean
    - `authUrl` string, uri
    - `message` string

## Other responses

- `400`: Bad request — invalid parameters or request body.
- `401`: Missing or invalid API key.
- `403`: Forbidden — insufficient permissions for this resource.

---

[API](https://skmtc.dev/loopfour/apis/loopfour-workflows-api.md) - [All operations](https://skmtc.dev/loopfour/apis/loopfour-workflows-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loopfour/apis/loopfour-workflows-api/revisions/872822a3af00?raw)