---
title: "Create a connection-scoped TeXML call"
method: POST
path: "/texml/calls/{connection_id}"
tags: ["TeXML REST Commands"]
---

# Create a connection-scoped TeXML call

`POST /texml/calls/{connection_id}`

Initiate an outbound TeXML call using a TeXML application connection ID, not an account SID. Request parameter names are case-sensitive. From and To are required; Texml supplies inline instructions and Url overrides the application XML request URL. When neither is supplied, the application configuration supplies the instructions. The response is a flat call object without a data wrapper.

## Path parameters

- `connection_id` string, required

## Request body

- object
  - `From` string, required — The E.164-formatted phone number or SIP URI to present as the caller.
  - `To` string, required — The E.164-formatted phone number or SIP URI to call.
  - `Texml` string — Inline TeXML instructions to execute when the call is answered.
  - `Url` string — The URL from which to retrieve TeXML instructions. Overrides the TeXML application XML request URL.
  - `Method` 'GET' | 'POST' — HTTP method used to retrieve TeXML instructions from Url.

## Response `200`

The outbound call was queued.

- object
  - `call_sid` string, required — The call control ID of the created call.
  - `from` string, required — The caller address.
  - `to` string, required — The called address.
  - `status` 'queued', required — The initial status of the outbound call.

## Other responses

- `401` — Unauthorized
- `422` — A required call parameter is missing or invalid.

## Changes

> 73 revisions in range; 1 not diffed.

- **2026-09-21** `d18924181c6e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/texml/calls/:connection_id/post.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/673109139443?raw)