---
title: "Play audio to conference participants"
method: POST
path: "/conferences/{id}/actions/play"
tags: ["Conference Commands"]
---

# Play audio to conference participants

`POST /conferences/{id}/actions/play`

Play audio to all or some participants on a conference call.

## Path parameters

- `id` string, required

## Request body

- ConferencePlayRequest
  - `audio_url` string — The URL of a file to be played back in the conference. media_name and audio_url cannot be used together in one request.
  - `media_name` string — The media_name of a file to be played back in the conference. The media_name must point to a file previously uploaded to api.telnyx.com/v2/media by the same user/organization. The file must either be a WAV or MP3 file.
  - `loop` union
    - string
    - integer
  - `call_control_ids` string[] — List of call control ids identifying participants the audio file should be played to. If not given, the audio file will be played to the entire conference.
  - `region` 'Australia' | 'Europe' | 'Middle East' | 'US' — Region where the conference data is located. Defaults to the region defined in user's data locality settings (Europe or US).

## Response `200`

Successful response upon making a conference command.

- object
  - `data` ConferenceCommandResult
    - `result` string, required

## Other responses

- `401` — Unauthorized. Authentication failed - the required authentication headers were either invalid or not included in the request.
- `404` — Resource not found. The requested resource does not exist. Common causes include: invalid call_control_id, conference not found, audio file not found, or recording not found.
- `422` — Unprocessable entity. The request was well-formed but could not be processed due to semantic errors. This includes validation errors, invalid parameter values, call state errors, conference errors, queue errors, recording/transcription errors, and business logic violations.

---

[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/versions/e32d46c5945b/schema)