Create a Conference

Create an empty Conference within the specified account. Making a Conference takes a short period of time. A 202 status code is returned if the Conference request was successfully queued by FreeClimb.

The waitUrl must remain accessible to FreeClimb until the conference is Terminated.

Further details about specific parameters can be found below:


The status of a conference will be reported to the statusCallbackUrl when:

  • The empty Conference is created, changing it to the empty status
  • The first participant joins the Conference, changing it to the populated status
  • The first participant whose startConfOnEnter property is set to true joins, changing it to the inProgress status
  • The last participant leaves the conference, changing it to the empty status

Participants can be added to a Conference once the statusCallbackUrl is invoked, signifying the Conference has been created and is empty. When a populated or inProgress Conference is terminated, this URL is called twice — once when the Conference becomes empty and then again when it is terminated.


This is a notification only. Any PerCL returned by the application is ignored.

The statusCallbackUrl is invoked using HTTP POST with the following parameters (in addition to the standard request parameters).

conferenceIdID of the conference created.
statusThe new status of the conference. Valid values: empty, populated, inProgress, terminated, or internalError. If an error occurs, the request can be retried. If it fails again, FreeClimb support should be contacted. Note there is no status callback posted for creating because the 202 response serves that purpose.
recordingUrlURL of the Conference’s recorded audio file. Populated only if a recording exists and the Conference was emptied.
recordingIdID of the recording from the Conference. Populated only if a recording exists and the Conference was emptied.
recordingDurationSecThe duration of the recorded audio (in seconds), rounded up to the nearest second. Populated only if a recording exists and the Conference was emptied.
Click Try It! to start a request and see the response here!