PATCH
/
api
/
v1
/
accounts
/
{account_id}
/
inboxes
/
{id}
Update Inbox
curl --request PATCH \
  --url https://app.chatwoot.com/api/v1/accounts/{account_id}/inboxes/{id} \
  --header 'Content-Type: application/json' \
  --header 'api_access_token: <api-key>' \
  --data '{
  "name": "Support",
  "greeting_enabled": true,
  "greeting_message": "Hello, how can I help you?",
  "enable_email_collect": true,
  "csat_survey_enabled": true,
  "enable_auto_assignment": true,
  "working_hours_enabled": true,
  "out_of_office_message": "We are currently out of office. Please leave a message and we will get back to you.",
  "timezone": "America/New_York",
  "allow_messages_after_resolved": true,
  "lock_to_single_conversation": true,
  "portal_id": 1,
  "sender_name_type": "friendly",
  "business_name": "My Business",
  "channel": {
    "website_url": "https://example.com",
    "welcome_title": "Welcome to our support",
    "welcome_tagline": "We are here to help you",
    "widget_color": "#FF5733"
  }
}'
{
  "id": 123,
  "name": "<string>",
  "website_url": "<string>",
  "channel_type": "<string>",
  "avatar_url": "<string>",
  "widget_color": "<string>",
  "website_token": "<string>",
  "enable_auto_assignment": true,
  "web_widget_script": "<string>",
  "welcome_title": "<string>",
  "welcome_tagline": "<string>",
  "greeting_enabled": true,
  "greeting_message": "<string>",
  "channel_id": 123,
  "working_hours_enabled": true,
  "enable_email_collect": true,
  "csat_survey_enabled": true,
  "auto_assignment_config": {},
  "out_of_office_message": "<string>",
  "working_hours": [
    {
      "day_of_week": 123,
      "closed_all_day": true,
      "open_hour": 123,
      "open_minutes": 123,
      "close_hour": 123,
      "close_minutes": 123,
      "open_all_day": true
    }
  ],
  "timezone": "<string>",
  "callback_webhook_url": "<string>",
  "allow_messages_after_resolved": true,
  "lock_to_single_conversation": true,
  "sender_name_type": "<string>",
  "business_name": "<string>",
  "hmac_mandatory": true,
  "selected_feature_flags": {},
  "reply_time": "<string>",
  "messaging_service_sid": "<string>",
  "phone_number": "<string>",
  "medium": "<string>",
  "provider": "<string>"
}

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

​
account_id
integer
required

The numeric ID of the account

​
id
number
required

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

Response

Success

​
id
number

ID of the inbox

​
name
string

The name of the inbox

​
website_url
string

Website URL

​
channel_type
string

The type of the inbox

​
avatar_url
string

The avatar image of the inbox

​
widget_color
string

Widget Color used for customization of the widget

​
website_token
string

Website Token

​
enable_auto_assignment
boolean

The flag which shows whether Auto Assignment is enabled or not

​
web_widget_script
string

Script used to load the website widget

​
welcome_title
string

Welcome title to be displayed on the widget

​
welcome_tagline
string

Welcome tagline to be displayed on the widget

​
greeting_enabled
boolean

The flag which shows whether greeting is enabled

​
greeting_message
string

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

Configuration settings for auto assignment

​
out_of_office_message
string

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

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

Business name associated with the inbox

​
hmac_mandatory
boolean

Whether HMAC verification is mandatory

​
selected_feature_flags
object

Selected feature flags for the inbox

​
reply_time
string

Expected reply time

​
messaging_service_sid
string

Messaging service SID for SMS providers

​
phone_number
string

Phone number associated with the inbox

​
medium
string

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

​
provider
string

Provider of the channel