---
title: "Create a Dialogflow Connection"
method: POST
path: "/dialogflow_connections/{connection_id}"
tags: ["Dialogflow Integration"]
---

# Create a Dialogflow Connection

`POST /dialogflow_connections/{connection_id}`

Save Dialogflow Credentiails to Telnyx, so it can be used with other Telnyx services.

## Path parameters

- `connection_id` string, required

## Request body

- DialogflowConnection
  - `service_account` object, required — The JSON map to connect your Dialoglow account.
  - `dialogflow_api` 'cx' | 'es' — Determine which Dialogflow will be used.
  - `conversation_profile_id` string — The id of a configured conversation profile on your Dialogflow account. (If you use Dialogflow CX, this param is required)
  - `location` string — The region of your agent is. (If you use Dialogflow CX, this param is required)
  - `environment` string — Which Dialogflow environment will be used.

## Response `201`

Return details of the Dialogflow connection associated with the given CallControl connection.

- DialogflowConnectionResponse
  - `data` object, required
    - `record_type` string
    - `connection_id` string — Uniquely identifies a Telnyx application (Call Control).
    - `conversation_profile_id` string — The id of a configured conversation profile on your Dialogflow account. (If you use Dialogflow CX, this param is required)
    - `environment` string — Which Dialogflow environment will be used.
    - `service_account` string — The JSON map to connect your Dialoglow account.

## Other responses

- `422` — Unprocessable entity. The request was well-formed but contains semantic errors.
- `default` — Unexpected error.

---

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