---
title: "Create Connection"
method: POST
path: "/api/connections"
tags: ["Connections"]
---

# Create Connection

`POST /api/connections`

Creates a new connection of the specified type.

Use [`GET /api/connection_types`](../../api-reference/connections/get-types) to retrieve the
list of available types and their parameter schemas. The `configuration`
object is type-specific; consult the [integration
guides](../../guides/configuring-your-connections/overview)
for the required and optional fields for each type.

> 📘 Polytomic validates the connection against the upstream service
> immediately on creation. The request will fail if the credentials or
> endpoint cannot be reached.

## Headers

- `X-Polytomic-Version` string

## Request body

- CreateConnectionRequestSchema
  - `configuration` object, required
  - `healthcheck_interval` string — Override interval for connection health checking.
  - `name` string, required
  - `organization_id` string, uuid, nullable
  - `policies` string[], nullable
  - `redirect_url` string — URL to redirect to after completing OAuth flow.
  - `type` string, required
  - `validate` boolean — Validate connection configuration.

## Response `200`

OK

- CreateConnectionResponseEnvelope
  - `data` CreateConnectionResponseSchema
    - `auth_code` string — Code to enter in order to complete connection authentication.
    - `auth_url` string — URL to visit to complete connection authentication.
    - `configuration` object, nullable
    - `healthcheck_interval` string — Interval for connection health checking.
    - `id` string, uuid
    - `name` string
    - `organization_id` string, uuid
    - `policies` string[]
    - `saved` boolean
    - `status` string
    - `status_error` string
    - `type` ConnectionTypeSchema
      - `id` string
      - `logo_dark_url` string
      - `logo_url` string
      - `name` string
      - `operations` string[], nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/polytomic/apis/polytomic-api.md) · [All operations](https://skmtc.net/polytomic/apis/polytomic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polytomic/polytomic-api/versions/b509e00e80aa/schema)