CommSync

Enqueue an inbox-classifier backfill across the caller’s historical mail. Classifies each not-yet-classified sending identity as PROMOTIONS / SPAM / NORMAL and auto-files its threads into the per-user Spam / Promotions buckets — one classification per sender, since the verdict applies to all of that sender’s threads. `unclassifiedSenders` is the upper bound the chain will scan. Completion is stamped on `inboxBackfillCompletedAt` in the AI settings when the last batch finishes. Senders the user has replied to, already filed by hand, or already classified are skipped. A key or app that is limited to some lines cannot use this tool: it files threads on every line.

trigger_inbox_backfill

Create a contact with a name and optional notes. It has no channels and no conversation yet: attach_identity_to_contact adds a channel, and the first message makes a conversation.

create_contact

Create a new label with a name and hex color (e.g. "#F97316").

create_label

Add a to-do to Home. Give threadId to tie it to a conversation the caller can open, or omit it for a to-do with no conversation. On one conversation, a to-do title must be unique.

create_todo

Delete one comment. The text is removed for good; the discussion keeps a "deleted" marker. The author can delete their own comment. A conversation manager can delete any comment on the conversation; on a contact-level discussion, only the contact owner or an org OWNER or ADMIN can delete the comment of another author.

delete_comment

Delete a contact that the caller owns. Each of its channels first becomes its own unnamed contact again, with its own conversation; messages and threads stay. If one channel cannot be detached, the delete stops and the contact stays.

delete_contact

Delete one draft of the caller. The draft text is gone for good. Its attachments stay unlinked and are removed later if no message uses them.

delete_draft

Delete a mailbox from the workspace. OWNER or ADMIN, or the member who connected the mailbox. The messages and conversations of the mailbox stay. For a mailbox connected with Sign in with Google, CommSync also revokes the grant at Google.

delete_email_account

Delete a label. This removes the label from all contacts and identities.

delete_label

Delete one checklist item from the caller's private note on one conversation. Returns the whole note.

delete_note_item

Delete a phone number from the workspace. OWNER or ADMIN only. The messages and conversations of the number stay. For a Twilio number, CommSync also removes its SMS webhook and voice settings at Twilio, where they still point at CommSync.

delete_phone_number

Delete a webhook endpoint and its delivery history. IRREVERSIBLE. Pending retries for this endpoint will no-op.

delete_webhook

Mark a daily digest as dismissed.

dismiss_digest

Take one conversation off both waiting lists of Home ("Mark completed" or "Stop waiting on this"). A newer message puts it back. Only Home changes: the inbox and the conversation stay the same. dismissed=false puts it back now.

dismiss_waiting

Get the bytes of one attachment as base64, for a file of 5 MB or less. A larger file answers FILE_TOO_LARGE with its size; read its text with get_attachment instead.

download_attachment

Forward a message to a new recipient. The source thread must be visible to the caller. A forward to email starts a new thread on the mailbox of the source message (or the first mailbox this credential can use) and carries the source files unless includeAttachments is false. A forward to SMS carries the text only. CommSync accepts the send and owns delivery from there, including provider rate limits: it paces, backs off, and retries, so this tool does not return a 429. The response carries `state` and `estimatedSendAt`. A `state` of "waiting_on_line" means the message is queued and goes out on its own. Each call without an `idempotencyKey` sends a new message. To retry a call safely, pass the same `idempotencyKey`: a repeat returns the first message with `deduplicated: true` and sends nothing.

forward_message

Manually trigger a daily digest generation for today or a specific date (at most 90 days back). A key or app that is limited to some lines cannot use this tool: the digest reads every line.

trigger_digest_run

Get the caller’s AI settings: the master switch, the label and inbox classifiers (with their thresholds), the Daily Brief schedule, thread titles, Ask, the writing tools, dictation, and to-dos. `configured` says whether the server has an AI key. `spendCap` is the workspace’s monthly AI spend cap in USD, its month-to-date spend, and whether the caller can change it.

get_ai_settings

Get the setup of one agent: name, role, status, autonomy mode, safety level, instructions, tone, signature, reply limits, quiet hours, group email settings, and each line with the task the agent handles there. It returns no credentials and no connected-tool secrets.

get_agent

Outcome counts and AI spend of every agent in the workspace over the last `days` days: sent, waiting for approval, escalated, skipped, rejected, and failed turns, the spend in USD, and the time of the last turn.

get_agent_stats

Get one attachment: filename, type, size, document kind, the message and thread it is on, and one page of its extracted text (PDF text, image OCR, document contents). When the result has nextOffset, more text follows: call again with offset set to nextOffset. textStatus says why a file has no text.

get_attachment

Get the billing state of the caller's workspace: the tier and subscription status, who bills it (`provider`: STRIPE, APPLE, GOOGLE, ADMIN, or null) and where the owner manages it (`management`), the seat count, the trial end and the deletion date of a cardless trial, `cardOnFile`, a tier that waits for the next store renewal, the caps (lines, storage bytes, agents) and the usage, the storage-full halt, the AI-credit balances with the auto-top-up settings (micro-USD strings), and the storage add-on blocks. Any member can call it, with a credential that has access to all channels. `isOwner` says whether the caller can use the tools that change billing.

get_billing_state

Get one contact with its channels and the caller’s permissions on it, the same as the contact page. Works for the caller’s own contact and for a contact that a teammate shared with the caller. A shared contact never shows its owner’s notes. The caller’s own contact also lists its labels.

get_contact

Get the caller's private note on one conversation: the free text, the color, and the checklist items (id, text, checked). Returns null when the caller has no note there. Teammates never see this note.

get_thread_note

Get the Daily Brief: the missed replies, priorities, and suggested actions of one day. With no date, returns the newest brief, the one the AI panel opens first. Before the 4 PM run of a day, that is the brief of the day before, which the 9 AM catch-up refreshed; `isToday` says which day it is. With a date, returns the brief of that date. A key or app that is limited to some lines gets only the items on those lines, and no headline or summary.

get_todays_digest

Get one draft of the caller: recipients, subject, the plain-text body (bodyText for email, smsBody for SMS), the sending line, the schedule, and the attachments.

get_draft

Get a single identity (phone number or email address) with its associated contact.

get_identity

Get one message by id, in the same compact shape as a get_thread_messages row. Answers MESSAGE_NOT_FOUND when the message does not exist, is hidden for the caller, or is outside the lines of the credential.

get_message

Get the current user profile (id, email, name, createdAt).

get_profile

Report how fast CommSync can currently send on each line the caller can access, and whether any line is waiting out a provider rate limit. `sustainedPerMinute` is the rate a line holds without queueing. A faster rate is not an error: CommSync queues and paces everything it accepts, so the extra messages wait longer. `waitingUntil` is set when a provider asked CommSync to pause; messages queued on that line go out on their own once it clears.

get_send_capacity

List the lines this credential can reply from on one thread: the phone numbers or mailboxes that took part in the conversation, plus the default line of the caller (`participated: false`). `preselected*` is the line the app picks first. When a send tool gets no line id on an existing thread, it uses the first line here that took part. For a group thread, `groupReply` says whether a reply can reach every member and, when it cannot, which app to reply in.

get_send_options

Get one shared contact: the name, the contact's addresses and numbers, the members with their permits, and the caller's permit.

get_shared_contact

Get one team: its contacts, its lines (identities), its members with their permits, its new-conversation policy, and the caller's permit.

get_team

Which agent covers one conversation, and whether a person took the conversation over (`takenOverAt`). On a line with many agents this is the agent that owns the thread, else the default agent of the line. `agent` is null when no agent covers the thread, or when the workspace limits agents to owners and admins and the caller is a member. Any member who can see the thread can use this tool.

get_thread_agent_status

Get the caller's unsent reply draft on one conversation, for one channel. Returns null when there is no reply draft.

get_thread_draft

Get the messages of a thread in time order, in a compact shape: plain-text body, sender, direction, status, origin (from and via), attachments, call details, one-time code, caution flag, labels, and read and star state. A body longer than maxBodyChars is cut and flagged. afterId polls for newer messages; before pages back.

get_thread_messages

Get one thread in the same compact shape as a list_threads row. Answers THREAD_NOT_FOUND when the thread does not exist or is outside the lines of the credential.

get_thread_summary

Get the number of threads with unread messages in each folder for the caller: inbox, all, automated, promotions, spam, archived, and deleted. A thread counts once, however many of its messages are unread.

get_unread_counts

Get a single webhook endpoint by id. No secret returned.

get_webhook

End a takeover. The agents on the line answer the next inbound message in this thread again; this call sends nothing by itself. Any member who can see the thread can use this tool.

hand_thread_back_to_agents