---
title: "Create conference"
method: POST
path: "/calls/1/conferences"
tags: ["channels", "voice", "calls", "conference-calls", "conference-management"]
---

# Create conference

`POST /calls/1/conferences`

## 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`
- 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`

Create a conference.

## Request body

- 707907921d4508c2925eddc2449f10db322ecc083be424f87c50fe97ccd8be40ConferenceRequest
  - `name` string: Conference name, will be auto-generated if not provided.
  - `recording` 4811a3a9108d5f90b8934012403f954f20270c436bdecbc318a80214cf54fc02ConferenceRecordingRequest
    - `recordingType` 'AUDIO' | 'AUDIO_AND_VIDEO', required: Recording type.
    - `conferenceComposition` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611ConferenceComposition
      - `enabled` boolean: Indicates whether to create a single recording of all participants. If set to `True`, all participants are merged into a single audio or video file. Otherwise, all participants will have their own individual audio or video file.
    - `customData` object: Custom data.
    - `filePrefix` string: Custom name for the recording's zip file. Applicable only when SFTP server is enabled on [Voice settings page](https://portal.infobip.com/apps/voice/recording/settings). Using the same `filePrefix` will override the files on the SFTP server. For recording without composition, `callId` and `fileId` will be appended to the `filePrefix` value.
  - `maxDuration` integer: Max duration in seconds.
  - `callsConfigurationId` string, required: 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).

## Response `201`

Conference created.

- 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`: Application 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)