--- title: "Dial a new conference participant" method: POST path: "/texml/Accounts/{account_sid}/Conferences/{conference_sid}/Participants" tags: ["TeXML REST Commands"] --- # Dial a new conference participant `POST /texml/Accounts/{account_sid}/Conferences/{conference_sid}/Participants` ## Request - Base URL: `https://api.telnyx.com/v2` - URL: `https://api.telnyx.com/v2/texml/Accounts/{account_sid}/Conferences/{conference_sid}/Participants` - Auth: HTTP bearer Dials a new participant into the specified conference and returns the created participant resource. ## Path parameters - `account_sid` string, required - `conference_sid` string, required ## Request body `application/x-www-form-urlencoded` - DialConferenceParticipantRequest - `Beep` 'true' | 'false' | 'onEnter' | 'onExit': Whether to play a notification beep to the conference when the participant enters and exits. - `StatusCallback` string: URL destination for Telnyx to send status callback events to for the call. - `StatusCallbackMethod` 'GET' | 'POST': HTTP request type used for `StatusCallback`. - `StatusCallbackEvent` string: The changes to the call's state that should generate a call to `StatusCallback`. Can be: `initiated`, `ringing`, `answered`, and `completed`. Separate multiple values with a space. The default value is `completed`. - `To` string: The phone number of the called party. Phone numbers are formatted with a `+` and country code. - `From` string: The phone number of the party that initiated the call. Phone numbers are formatted with a `+` and country code. - `Timeout` integer: The number of seconds that we should allow the phone to ring before assuming there is no answer. Can be an integer between 5 and 120, inclusive. The default value is 30. - `Muted` boolean: Whether the participant should be muted. - `StartConferenceOnEnter` boolean: Whether to start the conference when the participant enters. Defaults to `true`. - `EndConferenceOnExit` boolean: Whether to end the conference when the participant leaves. Defaults to `false`. - `Label` string: A unique label for the participant that will be added to the conference. The label can be used to reference the participant for updates via the TeXML REST API. - `EarlyMedia` boolean: Whether participant shall be bridged to conference before the participant answers (from early media if available). Defaults to `false`. - `ConferenceStatusCallback` string: The URL the conference callbacks will be sent to. - `ConferenceStatusCallbackMethod` 'GET' | 'POST': HTTP request type used for `ConferenceStatusCallback`. Defaults to `POST`. - `ConferenceStatusCallbackEvent` string: The changes to the conference's state that should generate a call to `ConferenceStatusCallback`. Can be: `start`, `end`, `join` and `leave`. Separate multiple values with a space. By default no callbacks are sent. - `WaitUrl` string: The URL to call for an audio file to play while the participant is waiting for the conference to start. - `MaxParticipants` integer: The maximum number of participants in the conference. Can be a positive integer from 2 to 800. The default value is 250. - `Coaching` boolean: Whether the participant is coaching another call. When `true`, `CallSidToCoach` has to be given. - `CallSidToCoach` string: The SID of the participant who is being coached. The participant being coached is the only participant who can hear the participant who is coaching. - `CallerId` string: To be used as the caller id name (SIP From Display Name) presented to the destination (`To` number). The string should have a maximum of 128 characters, containing only letters, numbers, spaces, and `-_~!.+` special characters. If ommited, the display name will be the same as the number in the `From` field. - `TimeLimit` integer: The maximum duration of the call in seconds. - `MachineDetection` 'Enable' | 'DetectMessageEnd': Whether to detect if a human or an answering machine picked up the call. Use `Enable` if you would like to ne notified as soon as the called party is identified. Use `DetectMessageEnd`, if you would like to leave a message on an answering machine. - `MachineDetectionTimeout` integer: How long answering machine detection should go on for before sending an `Unknown` result. Given in milliseconds. - `MachineDetectionSpeechThreshold` integer: Maximum threshold of a human greeting. If greeting longer than this value, considered machine. Ignored when `premium` detection is used. - `MachineDetectionSpeechEndThreshold` integer: Silence duration threshold after a greeting message or voice for it be considered human. Ignored when `premium` detection is used. - `MachineDetectionSilenceTimeout` integer: If initial silence duration is greater than this value, consider it a machine. Ignored when `premium` detection is used. - `MachineDetectionBeepProfile` 'both' | 'freq_only': Selects which detectors must validate a beep. `both` requires the amplitude and frequency detectors to agree. `freq_only` uses the frequency detector alone, for beeps whose volume is too unsteady for the default profile. Only used when MachineDetection is enabled. - `MachineDetectionBeepMinFrequency` integer: Lowest frequency, in Hz, that a tone must reach to be treated as a beep. Raising it above 480 excludes North American ringback (440 + 480 Hz), which can otherwise be reported as a beep when the `freq_only` profile is in use. Only used when MachineDetection is enabled. - `MachineDetectionBeepMaxFrequency` integer: Highest frequency, in Hz, that a tone can reach and still be treated as a beep. Only used when MachineDetection is enabled. - `MachineDetectionBeepMinToneDuration` integer: Shortest tone, in milliseconds, that can be treated as a beep. Raising it rejects brief tones such as call-progress blips. Only used when MachineDetection is enabled. - `MachineDetectionBeepSpectralConfirmation` boolean: When enabled, a candidate beep must pass an additional spectral check before it is reported. Only used when MachineDetection is enabled. - `MachineDetectionBeepSpectralWindow` integer: Length of the spectral confirmation window, in milliseconds. Only used when MachineDetection is enabled. - `MachineDetectionBeepSpectralMinPurity` number: Minimum spectral purity, from 0 to 1, for a tone to be treated as a beep. Raising it rejects mixed tones such as ringback, which combines two frequencies. Only used when MachineDetection is enabled. - `MachineDetectionBeepSpectralRejectFaxCng` boolean: When enabled, the fax CNG tone is rejected rather than reported as a beep. Only used when MachineDetection is enabled. - `AmdStatusCallback` string: The URL the result of answering machine detection will be sent to. - `AmdStatusCallbackMethod` 'GET' | 'POST': HTTP request type used for `AmdStatusCallback`. Defaults to `POST`. - `ApplicationSid` string: The SID of the TeXML application that will handle the new participant's call. Required unless joining an existing conference by its ConferenceSid. - `CancelPlaybackOnMachineDetection` boolean: Whether to cancel ongoing playback on `machine` detection. Defaults to `true`. - `CancelPlaybackOnDetectMessageEnd` boolean: Whether to cancel ongoing playback on `greeting ended` detection. Defaults to `true`. - `PreferredCodecs` string: The list of comma-separated codecs to be offered on a call. - `Record` boolean: Whether to record the entire participant's call leg. Defaults to `false`. - `RecordingChannels` 'mono' | 'dual': The number of channels in the final recording. Defaults to `mono`. - `RecordingStatusCallback` string: The URL the recording callbacks will be sent to. - `RecordingStatusCallbackMethod` 'GET' | 'POST': HTTP request type used for `RecordingStatusCallback`. Defaults to `POST`. - `RecordingStatusCallbackEvent` string: The changes to the recording's state that should generate a call to `RecoridngStatusCallback`. Can be: `in-progress`, `completed` and `absent`. Separate multiple values with a space. Defaults to `completed`. - `RecordingTrack` 'inbound' | 'outbound' | 'both': The audio track to record for the call. The default is `both`. - `SipAuthPassword` string: The password to use for SIP authentication. - `SipAuthUsername` string: The username to use for SIP authentication. - `Trim` 'trim-silence' | 'do-not-trim': Whether to trim any leading and trailing silence from the recording. Defaults to `trim-silence`. - `ConferenceRecord` 'true' | 'false' | 'record-from-start' | 'do-not-record': Whether to record the conference the participant is joining. Defualts to `do-not-record`. The boolean values `true` and `false` are synonymous with `record-from-start` and `do-not-record` respectively. - `ConferenceRecordingStatusCallback` string: The URL the conference recording callbacks will be sent to. - `ConferenceRecordingStatusCallbackMethod` 'GET' | 'POST': HTTP request type used for `ConferenceRecordingStatusCallback`. Defaults to `POST`. - `ConferenceRecordingStatusCallbackEvent` string: The changes to the conference recording's state that should generate a call to `RecoridngStatusCallback`. Can be: `in-progress`, `completed` and `absent`. Separate multiple values with a space. Defaults to `completed`. `failed` and `absent` are synonymous. - `ConferenceRecordingTimeout` integer: The number of seconds that Telnyx will wait for the recording to be stopped if silence is detected. The timer only starts when the speech is detected. Please note that the transcription is used to detect silence and the related charge will be applied. The minimum value is 0. The default value is 0 (infinite) - `ConferenceTrim` 'trim-silence' | 'do-not-trim': Whether to trim any leading and trailing silence from the conference recording. Defaults to `trim-silence`. - `CustomHeaders` object[]: Custom HTTP headers to be sent with the call. Each header should be an object with 'name' and 'value' properties. - `name` string, required: The name of the custom header - `value` string, required: The value of the custom header ## Response `200` New participant resource. - NewParticipantResource - `account_sid` string: The id of the account the resource belongs to. - `call_sid` string: The identifier of this participant's call. - `coaching` boolean: Whether the participant is coaching another call. - `coaching_call_sid` string: The identifier of the coached participant's call. - `end_conference_on_exit` boolean: Whether the conference ends when the participant leaves. - `hold` boolean: Whether the participant is on hold. - `muted` boolean: Whether the participant is muted. - `status` 'connecting' | 'connected' | 'completed': The status of the participant's call in the conference. - `uri` string: The relative URI for this participant. - `conference_sid` string, uuid: The unique identifier for the conference. ## Other responses - `404`: Resource not found ## Changes > 152 revisions in range; 1 not diffed. - **2026-09-23** `eaf7ad0b9886`: 7 info - added the new optional request property `MachineDetectionBeepMaxFrequency` - added the new optional request property `MachineDetectionBeepMinFrequency` - added the new optional request property `MachineDetectionBeepMinToneDuration` - added the new optional request property `MachineDetectionBeepSpectralConfirmation` - …3 more - **2026-09-16** `a6a61a29ecdd`: 1 info - added the new optional request property `MachineDetectionBeepProfile` [Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/texml/Accounts/:account_sid/Conferences/:conference_sid/Participants/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/f82938f53ff4?raw)