Add a new Participant to the Session
TODO: Resource-level docs
Add a new Participant to the Session
Body
-
FailOnParticipantConflict boolean
[Experimental] For accounts with the ProxyAllowParticipantConflict account flag, setting to true enables per-request opt-in to allowing Proxy to reject a Participant create request that could cause the same Identifier/ProxyIdentifier pair to be active in multiple Sessions. Depending on the context, this could be a 409 error (Twilio error code 80623) or a 400 error (Twilio error code 80604). If not provided, requests will be allowed to succeed and a Debugger notification (80802) will be emitted. Having multiple, active Participants with the same Identifier/ProxyIdentifier pair causes calls and messages from affected Participants to be routed incorrectly. Please note, the default behavior for accounts without the ProxyAllowParticipantConflict flag is to reject the request as described. This will eventually be the default for all accounts.
-
FriendlyName string
The string that you assigned to describe the participant. This value must be 255 characters or fewer. This value should not have PII.
-
The phone number of the Participant.
-
ProxyIdentifier string
The proxy phone number to use for the Participant. If not specified, Proxy will select a number from the pool.
-
ProxyIdentifierSid string
The SID of the Proxy Identifier to assign to the Participant.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^PN[0-9a-fA-F]{32}$
.
curl \
-X POST https://proxy.twilio.com/v1/Services/{ServiceSid}/Sessions/{SessionSid}/Participants \
--user "username:password" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d 'FailOnParticipantConflict=true&FriendlyName=string&Identifier=string&ProxyIdentifier=string&ProxyIdentifierSid=string'
{
"FailOnParticipantConflict": true,
"FriendlyName": "string",
"Identifier": "string",
"ProxyIdentifier": "string",
"ProxyIdentifierSid": "string"
}
{
"FailOnParticipantConflict": true,
"FriendlyName": "string",
"Identifier": "string",
"ProxyIdentifier": "string",
"ProxyIdentifierSid": "string"
}
{
"account_sid": "string",
"date_created": "2023-05-04T09:42:00+00:00",
"date_deleted": "2023-05-04T09:42:00+00:00",
"date_updated": "2023-05-04T09:42:00+00:00",
"friendly_name": "string",
"identifier": "string",
"links": {},
"proxy_identifier": "string",
"proxy_identifier_sid": "string",
"service_sid": "string",
"session_sid": "string",
"sid": "string",
"url": "https://example.com"
}
{
"account_sid": "string",
"date_created": "2024-05-04T09:42:00+00:00",
"date_deleted": "2024-05-04T09:42:00+00:00",
"date_updated": "2024-05-04T09:42:00+00:00",
"friendly_name": "string",
"identifier": "string",
"links": {},
"proxy_identifier": "string",
"proxy_identifier_sid": "string",
"service_sid": "string",
"session_sid": "string",
"sid": "string",
"url": "https://example.com"
}