---
title: "Add existing call"
method: PUT
path: "/calls/1/conferences/{conferenceId}/call/{callId}"
tags: ["channels", "voice", "calls", "conference-calls", "conference-management"]
---

# Add existing call

`PUT /calls/1/conferences/{conferenceId}/call/{callId}`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/calls/1/conferences/{conferenceId}/call/{callId}`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Add an existing call to a conference.

## Path parameters

- `conferenceId` string, required
- `callId` string, required

## Request body

- 707907921d4508c2925eddc2449f10db322ecc083be424f87c50fe97ccd8be40AddExistingCallRequest
  - `connectOnEarlyMedia` boolean: Indicates whether to add an existing call on early media. Otherwise, the call will be added after being established. This field is applicable for `OUTBOUND` calls only. Cannot be `true` when `ringbackGeneration` is enabled.
  - `ringbackGeneration` Efc1265916a727aef4eb46ff2e01c3e0ad0c1ad70cf38d568ed99c04a9a73fa0RingbackGeneration: Option to generate a consistent local ringback tone, overriding remote ringing tones. If enabled, the ringback will be generated for existing conference participants, if present, provided the new participant is added to the conference before its remote ringback starts. If the remote ringback has already started or finished, local ringback generation will not be applied.
    - `enabled` boolean: Flag indicating whether ringback generation is enabled. Cannot be `true` when `connectOnEarlyMedia` is `true`.
  - `role` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611Role: Represents the role of the call inside the conference.
    - `type` 'DEFAULT' | 'ADVISOR' | 'MONITOR' | 'LISTENER' | 'AUDITOR'
  - `customData` object: Optional parameter to update a call's custom data.

## Response `200`

Call added.

- C18e27d419b307552daa9403b0085ee796da1a5e57e2a4e6fb73f406471574fcConference
  - `id` string: Unique conference ID.
  - `name` string: Conference name, requested or autogenerated on creation.
  - `participants` C18e27d419b307552daa9403b0085ee796da1a5e57e2a4e6fb73f406471574fcParticipant[]: The list of conference participants.
    - `callId` string: Participant call ID.
    - `endpoint` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611CallEndpoint, required: Call endpoint. Represents a caller for the inbound calls and a callee for the outbound calls.
      - `type` 'PHONE' | 'SIP' | 'WEBRTC' | 'VIBER' | 'WHATSAPP' | 'WEBSOCKET'
    - `state` 'JOINING' | 'JOINED' | 'LEFT': Participant state.
    - `joinTime` string, date-time: Date and time when the participant has joined.
    - `leaveTime` string, date-time: Date and time when the participant has left.
    - `media` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611MediaProperties
      - `audio` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611AudioMediaProperties: Audio media properties.
        - `muted` boolean: Indicates whether the end user can speak.
        - `userMuted` boolean: Indicates whether the end user muted himself.
        - `deaf` boolean: Indicates whether the end user can hear.
      - `video` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611VideoMediaProperties: Video media properties.
        - `camera` boolean: Indicates whether there is a video feed.
        - `screenShare` boolean: Indicates whether the end user is sharing their screen.
        - `blind` boolean: Indicates whether the end user can receive remote videos.
    - `role` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611Role: Represents the role of the call inside the conference.
      - `type` 'DEFAULT' | 'ADVISOR' | 'MONITOR' | 'LISTENER' | 'AUDITOR'
  - `callsConfigurationId` string: Calls Configuration ID.
  - `platform` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611Platform: Platform options. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
    - `entityId` string: Required to use entity in a send request for outbound traffic. Returned in notification events. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
    - `applicationId` string: Required for application use in a send request for outbound traffic. Returned in notification events. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Conference or call not found.
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)