Skip to main content
Working HoursVersion: v3

Create Agent Working Hours

POST/conversation-ai/agents/{agentId}/working-hours

Creates the working-hours configuration for an AI agent. Returns 409 when one already exists — use the update endpoint to replace it.

Authorizations

Authorizationstringheaderrequired

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

Scope:conversation-ai.write
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Path Parameters

agentIdstringrequired

Conversations AI agent id

Example:EmployeeId123

Body

enabledbooleanrequired

Master toggle for working hours.

Example:false
channelsstring[]required

Channels the gate applies to. Must be non-empty when enabled.

Available optionsSMSEmailWhatsAppIGFBWebChatLive_ChatTIKTOK
Example:["SMS","WhatsApp"]
timezoneModestringrequired
Available optionscontactbusiness
scheduleobjectrequired
continueConversationsobjectrequired
offHoursAutoReplyobjectrequired
followUpobjectrequired

Response

Successful response

dataobjectrequired
successbooleanrequired
Example:true