Skip to main content

Add Participant To Call

POST 
/api/webphone/calls/:call_id/add-participant

Add a phone participant to an existing webphone call (conference call).

This enables multi-party calling by adding additional phone numbers to the same room. Multiple participants can be added to create a conference.

Flow:

  1. Verify call exists and is active
  2. Create SIP trunk for caller ID
  3. Create new SIP participant in same room as existing call
  4. Return participant info for frontend tracking

Args: call_id: ID of the existing call to add participant to request: AddParticipantRequest with phone number and optional caller ID web_context: Authenticated user context phone_call_service: Phone call service config: Application configuration

Returns: Dictionary with participant info:

  • participant_id: Unique identifier for this participant
  • sip_call_id: SIP call ID
  • phone_number: Phone number that was dialed
  • caller_id: Caller ID used
  • participant_identity: Participant identity
  • status: Participant status ("dialing")

Raises: HTTPException: 400 if invalid parameters, 404 if call not found, 500 if operation fails

Request​

Responses​

Successful Response