API Reference
Application API
- Account AgentBots
- Agents
- Canned Responses
- Custom Attributes
- Contacts
- Contact Labels
- Automation Rule
- Help Center
- Conversations
- Conversation Assignments
- Inboxes
- Messages
- Integrations
- Profile
- Teams
- Custom Filters
- Webhooks
- Reports
Platform API
- Accounts
- Account Users
- AgentBots
- Users
Client API
- Contacts API
- Conversations API
- Messages API
Other APIs
- CSAT Survey Page
Inboxes
List all inboxes
List all inboxes available in the current account
GET
https://app.chatwoot.com/
/
api
/
v1
/
accounts
/
{account_id}
/
inboxes
curl --request GET \
--url https://app.chatwoot.com/api/v1/accounts/{account_id}/inboxes \
--header 'api_access_token: <api-key>'
{
"payload": [
{
"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
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
The numeric ID of the account
Response
200
application/json
Success
The response is of type object
.
curl --request GET \
--url https://app.chatwoot.com/api/v1/accounts/{account_id}/inboxes \
--header 'api_access_token: <api-key>'
{
"payload": [
{
"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>"
}
]
}
Assistant
Responses are generated using AI and may contain mistakes.