Skip to main content
POST
Deploy an Apple Messages 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
integer
required

The numeric ID of the account

inbox_id
integer
required

The ID of the Inbox

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.