Skip to main content
PATCH
Update Inbox

Authorizations

api_access_token
string
header
required

This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.

Path Parameters

id
number
required

ID of the inbox

inbox_id
integer
required

The ID of the Inbox

Body

application/json
name
string

The name of the inbox

Example:

"Support"

avatar
file

Image file for avatar

greeting_enabled
boolean

Enable greeting message

Example:

true

greeting_message
string

Greeting message to be displayed on the widget

Example:

"Hello, how can I help you?"

enable_email_collect
boolean

Enable email collection

Example:

true

csat_survey_enabled
boolean

Enable CSAT survey

Example:

true

enable_auto_assignment
boolean

Enable Auto Assignment

Example:

true

working_hours_enabled
boolean

Enable working hours

Example:

true

out_of_office_message
string

Out of office message to be displayed on the widget

Example:

"We are currently out of office. Please leave a message and we will get back to you."

timezone
string

Timezone of the inbox

Example:

"America/New_York"

allow_messages_after_resolved
boolean

Allow messages after conversation is resolved

Example:

true

lock_to_single_conversation
boolean

Lock to single conversation

Example:

true

portal_id
integer

Id of the help center portal to attach to the inbox

Example:

1

sender_name_type
enum<string>

Sender name type for the inbox

Available options:
friendly,
professional
Example:

"friendly"

business_name
string

Business name for the inbox

Example:

"My Business"

channel
object

Channel settings to change. Which fields apply depends on the channel type.

Response

Success

id
number

ID of the inbox

name
string

The name of the inbox

website_url
string | null

Website URL

channel_type
string

The type of the inbox

avatar_url
string

The avatar image of the inbox

widget_color
string | null

Widget Color used for customization of the widget

website_token
string | null

Website Token

enable_auto_assignment
boolean

The flag which shows whether Auto Assignment is enabled or not

web_widget_script
string | null

Script used to load the website widget

welcome_title
string | null

Welcome title to be displayed on the widget

welcome_tagline
string | null

Welcome tagline to be displayed on the widget

greeting_enabled
boolean

The flag which shows whether greeting is enabled

greeting_message
string | null

A greeting message when the user starts the conversation

channel_id
number

ID of the channel this inbox belongs to

working_hours_enabled
boolean

The flag which shows whether working hours feature is enabled

enable_email_collect
boolean

The flag to enable collecting email from contacts

csat_survey_enabled
boolean

The flag to enable CSAT survey

auto_assignment_config
object

Auto-assignment configuration, including the per-agent conversation limit.

out_of_office_message
string | null

Message to show when agents are out of office

working_hours
object[]

Configuration for working hours of the inbox

timezone
string

Timezone configuration for the inbox

callback_webhook_url
string | null

Webhook URL for callbacks

allow_messages_after_resolved
boolean

Whether to allow messages after a conversation is resolved

lock_to_single_conversation
boolean

Whether to lock a contact to a single conversation

sender_name_type
string

Type of sender name to display (e.g., friendly)

business_name
string | null

Business name associated with the inbox

hmac_mandatory
boolean | null

Whether HMAC verification is mandatory

selected_feature_flags
object | null

Selected feature flags for the inbox

reply_time
string | null

Expected reply time

messaging_service_sid
string | null

Messaging service SID for SMS providers

phone_number
string | null

Phone number associated with the inbox

medium
string

Medium of communication (e.g., sms, email)

provider
string | null

Provider of the channel

csat_config
object

CSAT survey configuration for the inbox. Empty when the survey is off.

allowed_domains
string

Comma-separated domains the web widget may be embedded on. Empty means no restriction.

hmac_token
string

Secret used to compute the contact identifier_hash for identity verification. Treat it as a credential.

pre_chat_form_enabled
boolean

Whether the widget asks for details before starting a conversation.

pre_chat_form_options
object

The fields and message shown on the pre-chat form.

continuity_via_email
boolean

Whether replies continue by email once the visitor leaves the site.