Texa Desk Application API · Inboxes

Get an inbox

GET/api/v1/accounts/{account_id}/inboxes/{id}

Get an inbox available in the current account

Authorization

api_access_tokenheaderrequired

A person's access token (Texa Desk, Profile settings → Access token) or an agent bot's token, in the api_access_token header. It acts as that person, with their role's permissions.

Path parameters

account_idintegerrequired

The numeric ID of the account

idnumberrequired

ID of the inbox

Responses

200

Success

idnumber

ID of the inbox

namestring

The name of the inbox

website_urlstring

Website URL

page_idstring

Facebook Page ID associated with the inbox

instagram_idstring

Instagram account ID associated with the inbox

business_idstring

TikTok business ID associated with the inbox

provider_namestring

Provider username or page name associated with the social inbox

profile_idstring

X profile ID associated with the inbox

line_channel_idstring

LINE channel ID associated with the inbox

emailstring

Email address associated with the inbox

bot_namestring

Telegram bot name associated with the inbox

inbox_identifierstring

Public identifier associated with an API inbox

channel_typestring

The type of the inbox

avatar_urlstring

The avatar image of the inbox

widget_colorstring

Widget Color used for customization of the widget

website_tokenstring

Website Token

enable_auto_assignmentboolean

The flag which shows whether Auto Assignment is enabled or not

web_widget_scriptstring

Script used to load the website widget

welcome_titlestring

Welcome title to be displayed on the widget

welcome_taglinestring

Welcome tagline to be displayed on the widget

greeting_enabledboolean

The flag which shows whether greeting is enabled

greeting_messagestring

A greeting message when the user starts the conversation

channel_idnumber

ID of the channel this inbox belongs to

working_hours_enabledboolean

The flag which shows whether working hours feature is enabled

enable_email_collectboolean

The flag to enable collecting email from contacts

csat_survey_enabledboolean

The flag to enable CSAT survey

auto_assignment_configobject

Configuration settings for auto assignment

out_of_office_messagestring

Message to show when agents are out of office

working_hoursarray of object

Configuration for working hours of the inbox

working_hours[].day_of_weeknumber

Day of the week (0-6, where 0 is Sunday)

working_hours[].closed_all_dayboolean

Whether the inbox is closed for the entire day

working_hours[].open_hournumber

Hour when inbox opens (0-23)

working_hours[].open_minutesnumber

Minutes of the hour when inbox opens (0-59)

working_hours[].close_hournumber

Hour when inbox closes (0-23)

working_hours[].close_minutesnumber

Minutes of the hour when inbox closes (0-59)

working_hours[].open_all_dayboolean

Whether the inbox is open for the entire day

timezonestring

Timezone configuration for the inbox

callback_webhook_urlstring

Webhook URL for callbacks

allow_messages_after_resolvedboolean

Whether to allow messages after a conversation is resolved

lock_to_single_conversationboolean

Whether to lock a contact to a single conversation

sender_name_typestring

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

business_namestring

Business name associated with the inbox

branded_email_layoutstring

Liquid HTML layout for branded email replies. Available to administrators for Email inbox show/update responses.

hmac_mandatoryboolean

Whether HMAC verification is mandatory

selected_feature_flagsarray of string

Selected feature flags for the inbox

reply_timestring

Expected reply time

messaging_service_sidstring

Messaging service SID for SMS providers

phone_numberstring

Phone number associated with the inbox

mediumstring

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

providerstring

Provider of the channel

404

Inbox not found

descriptionstring

errorsarray of object

errors[].fieldstring

errors[].messagestring

errors[].codestring

403

Access denied

descriptionstring

errorsarray of object

errors[].fieldstring

errors[].messagestring

errors[].codestring

import os, requests headers = {"api_access_token": os.environ["TEXA_DESK_TOKEN"]} r = requests.get("https://desk.texadesk.com/api/v1/accounts/1/inboxes/1", headers=headers) r.raise_for_status() print(r.json())

{ "id": 1.0, "name": "string", "website_url": "string", "page_id": "string", "instagram_id": "string", "business_id": "string", "provider_name": "string", "profile_id": "string", "line_channel_id": "string", "email": "string", "bot_name": "string", "inbox_identifier": "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": 1.0, "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": 1.0, "closed_all_day": true, "open_hour": 1.0, "open_minutes": 1.0, "close_hour": 1.0, "close_minutes": 1.0, "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", "branded_email_layout": "string", "hmac_mandatory": true, "selected_feature_flags": [ "string" ], "reply_time": "string", "messaging_service_sid": "string", "phone_number": "string", "medium": "string", "provider": "string" }