---
title: "Create Connection"
method: POST
path: "/v1/connections"
tags: ["Data Plane"]
---

# Create Connection

`POST /v1/connections`

Create a new connection for an AI Agent to start a voice conversation

## Query parameters

- `agentId` string, required
- `prospect_id` string, nullable

## Request body

- ConnectionSource
  - `sourceName` 'TWILIO' | 'PLIVO' | 'BROWSER' — Name of the source
  - `sourceId` string, required — Unique identifier for the source
  - `sourceProps` object, required — Extra properties of source

## Response `200`

Successful Response

- Connection — This represents the connection between the user and the assistant
  - `id` string
  - `orgId` string
  - `sourceName` string
  - `sourceId` string
  - `sourceProps` object, nullable
  - `agentId` string
  - `prospectId` string, nullable
  - `createdBy` string
  - `createdAt` string, date-time
  - `updatedBy` string
  - `updatedAt` string, date-time

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/tratahq/apis/trata-ai-api.md) · [All operations](https://skmtc.net/tratahq/apis/trata-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tratahq/trata-ai-api/revisions/8f7b69ee5a90/schema)