---
title: "Create Account Connection"
method: POST
path: "/v1/account_connections/create"
tags: ["account_connections"]
---

# Create Account Connection

`POST /v1/account_connections/create`

## Request body

- union
  - TwilioAccountConnectionParams
    - `credentials` TwilioCredentials, required
      - `twilio_account_sid` string, required
      - `twilio_auth_token` string, required
    - `type` 'account_connection_twilio', required
    - `steering_pool` string[]
    - `account_supports_any_caller_id` boolean
  - OpenAIAccountConnectionParams
    - `credentials` OpenAICredentials, required
      - `openai_api_key` string, required
    - `type` 'account_connection_openai', required

## Response `200`

Successful Response

- union
  - TwilioAccountConnection
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `credentials` TwilioCredentials, required
      - `twilio_account_sid` string, required
      - `twilio_auth_token` string, required
    - `type` 'account_connection_twilio', required
    - `steering_pool` string[]
    - `account_supports_any_caller_id` boolean
  - OpenAIAccountConnection
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `credentials` OpenAICredentials, required
      - `openai_api_key` string, required
    - `type` 'account_connection_openai', required

## Other responses

- `422` — Validation Error

## Changes

- **2024-08-14** `63991d99e2e1` — 2 breaking, 2 info
  - the `type` request property const value `account_connection_openai` was added
  - the `type` request property const value `account_connection_twilio` was added
  - the `type` response property const value `account_connection_openai` was added for the status `200`
  - the `type` response property const value `account_connection_twilio` was added for the status `200`
- **2024-04-15** `47ab17602d64` — 4 info
  - added the new optional request property `oneOf[subschema #1: TwilioAccountConnectionParams]/account_supports_any_caller_id`
  - added the new optional request property `oneOf[subschema #1: TwilioAccountConnectionParams]/steering_pool`
  - added the optional property `oneOf[subschema #1: TwilioAccountConnection]/account_supports_any_caller_id` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: TwilioAccountConnection]/steering_pool` to the response with the `200` status
- **2023-12-01** `e5b6e245d522` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/changes/v1/account_connections/create/post.md)

---

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