Identify the Superchat user associated with this API key. Use this to confirm which account the server is connected to.

List one page of connected channels in this workspace, such as WhatsApp, Instagram Direct, Facebook Messenger, SMS, email, Telegram, Live Chat or phone. Use a returned channel_id when sending. Use after or before to continue from a previous page; each call returns only one page.

Read one connected channel's configuration by ID, for example before choosing a channel for a message.

List one page of inboxes that organize conversations in this workspace. Use inbox IDs when routing a conversation. Use after or before to continue from a previous page; each call returns only one page.

Read one inbox's details by ID.

List one page of workspace users. Use their IDs when assigning conversations. Use after or before to continue from a previous page; each call returns only one page.

Read one workspace user's details by ID.

List one page of labels used to organize conversations. Labels belong to conversations, not contacts. Use after or before to continue from a previous page; each call returns only one page.

Read one conversation label by ID. Labels apply to conversations, not contacts.

List one page of contact lists used to group contacts for segmentation and campaigns. Results contain list metadata (ID, name and URL), not participants; use list_contact_lists_for_contact to find a contact's memberships. Use after or before to continue from a previous page; each call returns only one page.

Read a contact list's metadata (ID, name and URL) by ID. This endpoint does not return participants; use list_contact_lists_for_contact for a contact's memberships.

List one page of metadata for files already uploaded to Superchat. Use file IDs for message attachments; this does not download file contents. Use after or before to continue from a previous page; each call returns only one page.

Read metadata for one uploaded file by ID. This does not download its contents.

List one page of custom contact attributes with their IDs, types and allowed values. Look up an attribute ID here before searching by or updating that attribute.

List one page of message templates. Filter by channel_id or template type, then inspect approval status and positional variables before sending a template.

Read one template's content, approval status and positional variables before sending it. Use this instead of list_templates when you already have the template ID.

List one page of contacts, newest first. For an exact email, phone, Instagram or custom-attribute match, use search_contacts instead of scanning pages.

Read one contact's details, handles and custom attributes by ID. Use this before update_contact because supplied handle and attribute arrays replace their full lists.

Find contacts with one exact equality match on email, phone, Instagram ID or a custom attribute. This is a read-only POST; it does not support fuzzy name search or combining conditions. Use list_contacts to browse instead.

List one page of conversation threads for a contact across its channels. Results are conversation records, not message history; use list_conversation_messages for messages when Enterprise access is enabled.

List one page of contact lists that contain this contact. Use this to inspect membership; list_contact_lists and get_contact_list return only list metadata, not participants.

List one page of conversation threads across the workspace. Results contain conversation metadata, not messages, and the public endpoint has no status, inbox or text filter. Use list_contact_conversations to scope the list to one contact.

Read one conversation thread's contact, channel, inbox, status and channel-specific messaging time window. Use list_conversation_messages for its message history when Enterprise access is enabled. Conversation status (such as open) does not determine whether a channel's messaging window is open.

List one page of internal notes attached to a conversation. These notes are visible to the team, not customer messages; use list_conversation_messages for message history when Enterprise access is enabled.

Read one internal note from a conversation by note ID. This does not retrieve a customer message.

Check the status of an asynchronous conversation export job and retrieve its download link. Use after create_conversation_export; this tool returns the URL but does not fetch or parse the file.