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

# Create connection

`POST /api/connections`

## Request

- Base URL: `https://api.chirpwireless.io`
- URL: `https://api.chirpwireless.io/api/connections`
- Auth: API key in header `X-API-Key` and API key in header `X-Organization-Id`

Create a new device connection with type and configuration.

**Required scope:** `connections:write`

## Request body

- object
  - `configuration` object
  - `connectorId` integer, required
  - `name` string, required
  - `organizationId` string, required

## Response `200`

Successful response

## Other responses

- `401`: Missing or invalid API key
- `403`: Insufficient permissions (missing required scope)

---

[API](https://skmtc.dev/chirpwireless/apis/chirp-public-api.md) · [All operations](https://skmtc.dev/chirpwireless/apis/chirp-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chirpwireless/apis/chirp-public-api/revisions/0414f3e239ff?raw)
