Skip to main content
POST
/
ai
/
conversations
JavaScript
import Telnyx from 'telnyx';

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

const conversation = await client.ai.conversations.create();

console.log(conversation.id);
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "created_at": "2025-04-15T13:07:28.764Z",
  "metadata": {
    "telnyx_conversation_channel": "phone_call",
    "telnyx_agent_target": "+13128675309",
    "telnyx_end_user_target": "+13128675309",
    "assistant_id": "assistant-123"
  },
  "last_message_at": "2025-04-15T13:07:28.764Z",
  "name": ""
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
​
metadata
object

Metadata associated with the conversation.

Response

Successful Response

​
id
string<uuid>
required
Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

​
created_at
string<date-time>
required

The datetime the conversation was created.

Example:

"2025-04-15T13:07:28.764Z"

​
metadata
object
required

Metadata associated with the conversation. Telnyx provides several pieces of metadata, but customers can also add their own.

Example:
{
  "telnyx_conversation_channel": "phone_call",
  "telnyx_agent_target": "+13128675309",
  "telnyx_end_user_target": "+13128675309",
  "assistant_id": "assistant-123"
}
​
last_message_at
string<date-time>
required

The datetime of the latest message in the conversation.

Example:

"2025-04-15T13:07:28.764Z"

​
name
string
Example:

""