Create a meeting session

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const MeetingSession = await client.meetingSessions.create({
  meeting_url: 'meeting_url',
});

console.log(MeetingSession.data);

import os
from telnyx import Telnyx

client = Telnyx(
    api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
)
create_meeting_session = client.meeting_sessions.create(
    meeting_url="meeting_url",
)
print(create_meeting_session.data)

package main

import (
	"context"
	"fmt"

	"github.com/team-telnyx/telnyx-go"
	"github.com/team-telnyx/telnyx-go/option"
)

func main() {
	client := telnyx.NewClient(
		option.WithAPIKey("My API Key"),
	)
	meetingSession, err := client.MeetingSessions.New(
		context.TODO(),
		telnyx.MeetingSessionNewParams{
			MeetingURL: "meeting_url",
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", meetingSession.Data)
}

package com.telnyx.sdk.example;

import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.meetingSessions.MeetingSessionCreateParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        TelnyxClient client = TelnyxOkHttpClient.fromEnv();

        MeetingSessionCreateParams params = MeetingSessionCreateParams.builder()
            .meetingUrl("meeting_url")
            .build();
        var response = client.meetingSessions().create(params);
    }
}

require "telnyx"

telnyx = Telnyx::Client.new(api_key: "My API Key")

create_meeting_session = telnyx.meeting_sessions.create(meeting_url: "meeting_url")

puts(create_meeting_session)

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');

try {
  $create_meeting_session = $client->meetingSessions->create(
    meeting_url: 'meeting_url',
  );

  var_dump($create_meeting_session);
} catch (APIException $e) {
  echo $e->getMessage();
}

telnyx meeting-sessions create \
  --api-key 'My API Key' \
  --meeting-url meeting_url

curl --request POST \
  --url https://api.telnyx.com/v2/meeting_sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "meeting_url": "https://zoom.us/j/1234567890",
  "bot_name": "Notetaker"
}
'

{
  "data": {
    "id": "<string>",
    "account_id": "<string>",
    "provider": "<string>",
    "status": "scheduled",
    "status_detail": "<string>",
    "recording": true,
    "meeting_url": "<string>",
    "platform": "zoom",
    "bot_name": "<string>",
    "config": {
      "voice": "<string>",
      "speak_on_enter": "<string>",
      "chat_on_enter": "<string>",
      "barge_in": true,
      "summarize_on_end": true
    },
    "avatar": {
      "provider": "telnyx",
      "model": "<string>",
      "avatar_id": "<string>",
      "background_id": "<string>"
    },
    "avatar_state": "starting",
    "avatar_state_changed_at": "2023-11-07T05:31:56Z",
    "assistant": {
      "id": "<string>",
      "audio_gate": "half_duplex",
      "dynamic_variables": {},
      "leave_on_end": true
    },
    "assistant_state": "starting",
    "assistant_state_changed_at": "2023-11-07T05:31:56Z",
    "webhook_url": "<string>",
    "metadata": {},
    "failure_reason": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "join_at": "2023-11-07T05:31:56Z",
    "joined_at": "2023-11-07T05:31:56Z",
    "ended_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

{
  "data": {
    "id": "mtgsess_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "account_id": "acct_fake-uuid-0001",
    "provider": "telnyx",
    "status": "scheduled",
    "status_detail": null,
    "recording": false,
    "meeting_url": "https://zoom.us/j/1234567890",
    "platform": "zoom",
    "bot_name": "Notetaker",
    "config": {
      "voice": null,
      "speak_on_enter": null,
      "barge_in": false,
      "summarize_on_end": false,
      "chat_on_enter": null
    },
    "avatar": null,
    "avatar_state": null,
    "avatar_state_changed_at": null,
    "assistant": null,
    "assistant_state": null,
    "assistant_state_changed_at": null,
    "webhook_url": null,
    "metadata": {},
    "failure_reason": null,
    "created_at": "2026-07-30T12:00:00Z",
    "join_at": "2026-07-30T13:00:00Z",
    "joined_at": null,
    "ended_at": null,
    "updated_at": "2026-07-30T12:00:00Z"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "request is invalid"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "invalid or missing credentials"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "credential is not permitted"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "request body too large"
  }
}

{
  "error": {
    "code": "unsupported_capability",
    "message": "avatar video is not supported on platform 'unknown'"
  }
}

{
  "error": {
    "code": "auth_overloaded",
    "message": "authentication temporarily overloaded"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "internal server error"
  }
}

{
  "error": {
    "code": "provider_error",
    "message": "meeting provider rejected bot creation"
  }
}

{
  "error": {
    "code": "not_configured",
    "message": "required feature is not configured"
  }
}