Create a scheduled event

POST 
/ai/assistants/:assistant_id/scheduled_events

Create a scheduled event for an assistant

Path Parameters

assistant_id Assistant Idrequired

application/json

Body

required

telnyx_conversation_channel ConversationChannelType (string)required

Possible values: [phone_call, sms_chat]

telnyx_end_user_target Telnyx End User Target (string)required

The phone number, SIP URI, to schedule the call or text to.

telnyx_agent_target Telnyx Agent Target (string)required

The phone number, SIP URI, to schedule the call or text from.

scheduled_at_fixed_datetime date-timerequired

The datetime at which the event should be scheduled. Formatted as ISO 8601.

text string

Required for sms scheduled events. The text to be sent to the end user.

conversation_metadata

object

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

property name*

object

anyOf

• MOD1
• MOD2
• MOD3

string

integer

boolean

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

201: Successful Response

application/json

• Schema
• Example (from schema)

Schema

anyOf

• ScheduledPhoneCallEventResponse
• ScheduledSmsEventResponse

telnyx_conversation_channel ConversationChannelType (string)required

Possible values: [phone_call, sms_chat]

telnyx_end_user_target Telnyx End User Target (string)required

telnyx_agent_target Telnyx Agent Target (string)required

scheduled_at_fixed_datetime date-timerequired

assistant_id Assistant Id (string)required

retry_count Retry Count (integer)

Default value: 0

retry_attempts Retry Attempts (integer)

scheduled_event_id Scheduled Event Id (string)

conversation_id Conversation Id (string)

created_at date-time

status EventStatus (string)

Possible values: [pending, in_progress, completed, failed]

conversation_metadata

object

property name*

object

anyOf

• MOD1
• MOD2
• MOD3

string

integer

boolean

errors string[]

telnyx_conversation_channel ConversationChannelType (string)required

Possible values: [phone_call, sms_chat]

telnyx_end_user_target Telnyx End User Target (string)required

telnyx_agent_target Telnyx Agent Target (string)required

scheduled_at_fixed_datetime date-timerequired

assistant_id Assistant Id (string)required

retry_count Retry Count (integer)

Default value: 0

text Text (string)required

scheduled_event_id Scheduled Event Id (string)

conversation_id Conversation Id (string)

created_at date-time

status EventStatus (string)

Possible values: [pending, in_progress, completed, failed]

conversation_metadata

object

property name*

object

anyOf

• MOD1
• MOD2
• MOD3

string

integer

boolean

errors string[]

{}

422: Validation Error

application/json

• Schema
• Example (from schema)

Schema

detail

object[]

Array [

loc

object[]

required

Array [

anyOf

• MOD1
• MOD2

string

integer

]

msg Message (string)required

type Error Type (string)required

]

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Request samples

• cURL

---

curl -L 'https://api.telnyx.com/v2/ai/assistants/:assistant_id/scheduled_events' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "telnyx_conversation_channel": "phone_call",
  "telnyx_end_user_target": "string",
  "telnyx_agent_target": "string",
  "scheduled_at_fixed_datetime": "2025-04-15T13:07:28.764Z",
  "text": "string",
  "conversation_metadata": {}
}'

Response samples

• 201
• 422

---

{}

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}