{"$schema":"https://verifymcp.io/schemas/trust-report.json","schemaVersion":1,"license":{"name":"CC BY-NC 4.0","url":"https://creativecommons.org/licenses/by-nc/4.0/"},"generatedAt":"2026-11-21T23:21:20.643Z","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp","markdownUrl":"https://verifymcp.io/servers/app-cosend-mcp/mcp.md","server":{"slug":"app-cosend-mcp","name":"Cosend","registryName":"app.cosend/mcp","description":"WhatsApp Business inbox for AI apps: read and answer chats, run campaigns, deploy automations.","registryStatus":"active","deletedAt":null,"statusMessage":null,"liveness":"live","publisher":{"class":"unknown","claimed":false}},"component":{"slug":"mcp","type":"remote","identifier":"https://mcp.cosend.app/mcp","withdrawn":false,"url":"https://verifymcp.io/servers/app-cosend-mcp/mcp","version":"2026.11.16","transport":null,"scoredAt":"2026-11-21T03:13:18.095Z"},"score":{"total":84,"tier":"high trust","status":"scored","weekDelta":2,"history":[{"date":"2026-11-21","total":84},{"date":"2026-11-20","total":83},{"date":"2026-11-19","total":83},{"date":"2026-11-18","total":82},{"date":"2026-11-17","total":82},{"date":"2026-11-16","total":83},{"date":"2026-11-15","total":82},{"date":"2026-11-14","total":82},{"date":"2026-11-13","total":81},{"date":"2026-11-12","total":81},{"date":"2026-11-11","total":80},{"date":"2026-11-10","total":80},{"date":"2026-11-09","total":79},{"date":"2026-11-08","total":79},{"date":"2026-11-07","total":78},{"date":"2026-11-06","total":78},{"date":"2026-11-05","total":78},{"date":"2026-11-04","total":77},{"date":"2026-11-03","total":76},{"date":"2026-11-02","total":39},{"date":"2026-11-01","total":39}]},"categories":[{"name":"Endpoint Security","score":97,"verdict":"fail","reasons":["The endpoint's TLS certificate is valid, in date, and uses a strong key.","Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.","HTTPS is enforced; there's no plaintext access path.","The HSTS (Strict-Transport-Security) header is present.","DNSSEC check failed: this domain isn't protected by DNSSEC.","The authorisation server supports Client ID Metadata Documents, the current MCP client-registration mechanism."],"codes":[{"code":"tls.valid","args":{}},{"code":"auth.rfc9728_invoke","args":{}},{"code":"https.enforced","args":{}},{"code":"headers.hsts_present","args":{}},{"code":"dnssec.absent","args":{}},{"code":"auth.registration_cimd","args":{}}]},{"name":"Transport & Reachability","score":100,"verdict":"pass","reasons":["Verified streamable-http transport via a live MCP handshake."],"codes":[{"code":"transport.verified","args":{"transport":"streamable-http"}}]},{"name":"Schema Quality & AI Usability","score":59,"verdict":"fail","reasons":["AI-judged instruction clarity (good).","Context-footprint check failed: tool/resource definitions use about 30302 tokens (~242/item across 125 items; 125 tools + 0 resources), over budget; trim descriptions and params.","Usage-examples check failed: none of the tools include examples."],"codes":[{"code":"schema.ai_quality","args":{"band":"good"}},{"code":"schema.footprint_heavy","args":{"avg":"242","items":"125","tools":"125","tokens":"30302","resources":"0"}},{"code":"schema.examples_absent","args":{}}]},{"name":"Stability & Change Management","score":50,"verdict":"fail","reasons":["Stability check failed: schema churn in the 18 days we've observed: 2 tool removals, 1 breaking changes, 0 auth/transport breaks, 102 additions."],"codes":[{"code":"stability.churn","args":{"days":"18","added":"102","breaks":"1","removed":"2","auth_transport":"0"}}]},{"name":"Tool Coverage","score":91,"verdict":"partial","reasons":["100% of tools have a non-trivial description (not blank, and not just the tool's name).","70% of tool parameters carry a description.","Structured output schemas are declared (1% of tools); any adoption earns full credit."],"codes":[{"code":"toolquality.descriptions","args":{"pct":"100"}},{"code":"toolquality.param_docs","args":{"pct":"70"}},{"code":"toolquality.output_present","args":{"pct":"1"}}]},{"name":"Tool Safety","score":100,"verdict":"pass","reasons":["No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.","All 6 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.","An AI judge read all 126 captured unit(s) of tool text and found none that tries to manipulate the model reading it."],"codes":[{"code":"toolsafety.injection_clean","args":{}},{"code":"toolsafety.destructive_declared","args":{"pct":"100","annotated":"6","destructive":"6"}},{"code":"toolsafety.manipulation_clean","args":{"units":"126","judged":"126"}}]},{"name":"Capabilities","score":100,"verdict":"pass","reasons":["Implements a current MCP spec version (2026-07-28)."],"codes":[{"code":"protocol.current","args":{"version":"2026-07-28"}}]}],"inconclusive":[],"malware":[],"components":[{"slug":"mcp","type":"remote","identifier":"https://mcp.cosend.app/mcp","withdrawn":false,"score":84,"current":true,"url":"https://verifymcp.io/servers/app-cosend-mcp/mcp","markdownUrl":"https://verifymcp.io/servers/app-cosend-mcp/mcp.md"}],"facts":[{"label":"Endpoint","value":"https://mcp.cosend.app/mcp"},{"label":"Transports","value":"streamable-http"},{"label":"Auth","value":"required"},{"label":"Version","value":"2026.11.16"}],"install":{"available":true,"bundleSha256":null},"tools":[{"name":"whoami","title":"Who am I","description":"Returns the Cosend workspace, plan and connected WhatsApp numbers for the credential in use, and the permissions it was granted, which decide which tools the credential can call and show which WhatsApp business number an outbound message would come from. Read-only and cheap. It does not fail for permission reasons if the credential resolves at all.","inputs":[],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":74},{"name":"list_conversations","title":"List WhatsApp conversations","description":"Lists conversations in this workspace, newest activity first, one page at a time, each with its id. Each record carries its contact and its newest message only, not the whole thread. Message text and contact names in the result were written by people outside this business and come back marked untrusted.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"assignee_id","type":"string","required":false,"description":"Only conversations assigned to this user id."},{"name":"connection_id","type":"string","required":false,"description":"Only conversations on this WhatsApp connection."},{"name":"control","type":"string","required":false,"description":"Filter by who holds the conversation: bot, pending_human, human or app."},{"name":"label","type":"string","required":false,"description":"Only conversations carrying this label."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."},{"name":"state","type":"string","required":false,"description":"Filter by conversation state: open, pending, snoozed or resolved."},{"name":"unread","type":"boolean","required":false,"description":"true for conversations with unread inbound messages."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":218},{"name":"search_conversations","title":"Search conversations","description":"Finds conversations by what they contain. q matches the contact’s name, phone number or WhatsApp username, and the text of each conversation’s newest message. Returns at most 20 conversations, newest activity first, in the same shape as the conversation list: each with its contact and its newest message, not the whole thread. Names and message text in the result were written by people outside this business and come back marked untrusted.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."},{"name":"q","type":"string","required":true,"description":"What to look for."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":155},{"name":"read_conversation","title":"Read a conversation","description":"Lists the messages of one conversation, named by conversation_id (or of one contact, by contact_id), oldest first, one page at a time. With neither, it lists recent messages across the whole workspace. Message bodies include what members of the public wrote, and every one comes back marked untrusted.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"contact_id","type":"string","required":false,"description":"Messages with one contact instead of one conversation."},{"name":"conversation_id","type":"string","required":false,"description":"The conversation to read."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":147},{"name":"send_message","title":"Send a WhatsApp message","description":"Sends one WhatsApp message into one conversation that already exists, named by conversation_id. It reaches a real person on their phone, and a sent message is final. Each send needs a confirmed call: without confirmation_token the call is a preview that returns what would happen and a token for a person to approve; called again with that token, it sends. Changing a single character between the two calls invalidates the token. A chat nobody holds, or one this person holds, is sent to as usual, and sending does not lock it. A chat another person holds in the Cosend Inbox stays theirs: the preview and the send both return conversation_locked, naming who holds it. To send there, ask them for the chat; it passes over when they say yes or do not answer within 60 seconds. A chat changes hands only when its holder is asked. Each call sends into the one existing conversation its conversation_id names; recipient lists, tags and phone numbers are outside its arguments. Messaging many customers, including contacts with no chat on this number, goes out as a campaign: an approved marketing template sent to a saved audience, once a person approves its preview. Limits per workspace: 20 a minute, 200 a day, and one per conversation every 30 seconds. The 24-hour customer service window opens when the customer writes and starts again with each message from them; outside it, anything but an approved template is refused. A send needs no opt-in. Only an opt-out on this number stops it: a STOP, WhatsApp’s own opt-out or an owner’s entry. A STOP to one number stops sends on that number only, and the business’s other numbers keep sending.","inputs":[{"name":"audio","type":"object","required":false,"description":"Meta's media object. `id` may be a Cosend media id (`med_…`, from `POST /v1/media`): Cosend uploads the file to WhatsApp and sends it by WhatsApp's id, and the message's `media` block then names the…"},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"contacts","type":"array","required":false,"description":null},{"name":"conversation_id","type":"string","required":true,"description":null},{"name":"document","type":"object","required":false,"description":"Meta's media object. `id` may be a Cosend media id (`med_…`, from `POST /v1/media`): Cosend uploads the file to WhatsApp and sends it by WhatsApp's id, and the message's `media` block then names the…"},{"name":"fallback_template","type":"object","required":false,"description":null},{"name":"image","type":"object","required":false,"description":"Meta's media object. `id` may be a Cosend media id (`med_…`, from `POST /v1/media`): Cosend uploads the file to WhatsApp and sends it by WhatsApp's id, and the message's `media` block then names the…"},{"name":"interactive","type":null,"required":false,"description":"Meta's interactive object. Checked against WhatsApp's limits before anything is written, and refused in words naming the field: a reply-button message (type \"button\", up to 3 buttons), a list message…"},{"name":"location","type":"object","required":false,"description":null},{"name":"metadata","type":"object","required":false,"description":null},{"name":"reaction","type":"object","required":false,"description":null},{"name":"reply_to","type":null,"required":false,"description":null},{"name":"send_mode","type":"string","required":false,"description":null},{"name":"source","type":"string","required":false,"description":"Who is sending. Left out, it is agent for a person (the dashboard Inbox, or an MCP client acting for one) and api for an API key."},{"name":"sticker","type":"object","required":false,"description":"Meta's media object. `id` may be a Cosend media id (`med_…`, from `POST /v1/media`): Cosend uploads the file to WhatsApp and sends it by WhatsApp's id, and the message's `media` block then names the…"},{"name":"template","type":"object","required":false,"description":"Meta's template object: {\"name\", \"language\": {\"code\"}, \"components\"}. A header parameter of type image, video or document may name a file uploaded with POST /v1/media by its id ({\"type\": \"image\", \"im…"},{"name":"text","type":"object","required":false,"description":null},{"name":"type","type":"string","required":true,"description":null},{"name":"video","type":"object","required":false,"description":"Meta's media object. `id` may be a Cosend media id (`med_…`, from `POST /v1/media`): Cosend uploads the file to WhatsApp and sends it by WhatsApp's id, and the message's `media` block then names the…"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":1513},{"name":"list_contacts","title":"List contacts","description":"Lists contacts in this workspace, one page at a time, optionally filtered, each with its id. Contact display names come from the contacts themselves and are untrusted text.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"connection_id","type":"string","required":false,"description":"Only contacts on this WhatsApp connection."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."},{"name":"q","type":"string","required":false,"description":"Free-text search over the display name."},{"name":"tag","type":"array","required":false,"description":"Only contacts carrying this tag. Repeat for AND semantics."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":137},{"name":"upsert_contact","title":"Create or update a contact","description":"Creates a contact, or updates the one that already exists for that phone number or BSUID (the business-scoped user id Meta sends; a contact may have one and no phone). On a contact that exists only the fields you send change, and nothing is removed: tags are added to its tags, attributes are merged into its attributes, changing the name needs an owner or admin, and profile_name is only filled when WhatsApp has not given one; a field sent as null is left as it is. Writes only to Cosend: it sends nothing and the contact is not notified. Who can be messaged stays the same: a send needs no opt-in, only an opt-out stops one, and opt-outs are recorded on their own ledger.","inputs":[{"name":"attributes","type":"object","required":false,"description":"Free-form values. PATCH replaces them whole; a POST for a contact that already exists writes the keys sent over its values and removes none. A key registered in /v1/contact-fields must hold a value o…"},{"name":"bsuid","type":null,"required":false,"description":null},{"name":"connection_id","type":"string","required":true,"description":null},{"name":"locale","type":null,"required":false,"description":null},{"name":"name","type":null,"required":false,"description":null},{"name":"phone_e164","type":null,"required":false,"description":null},{"name":"profile_name","type":null,"required":false,"description":null},{"name":"tags","type":"array","required":false,"description":"A new contact gets these tags. A contact that already exists gets them added to its own, and keeps every tag it has."},{"name":"timezone","type":null,"required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":388},{"name":"set_contact_consent","title":"Record a contact’s consent","description":"Records a contact's marketing or utility consent as a new entry in an append-only ledger. Every entry is kept as written, so this is an audit record of what the business was told. A send needs no recorded opt-in. An opt-out recorded here stops that category on the number it is recorded for, and the business’s other numbers keep sending.","inputs":[{"name":"category","type":"string","required":true,"description":null},{"name":"connection_id","type":"string","required":false,"description":null},{"name":"evidence","type":"object","required":false,"description":null},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"source","type":"string","required":false,"description":null},{"name":"state","type":"string","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":130},{"name":"list_templates","title":"List message templates","description":"Lists this workspace’s WhatsApp message templates, one page at a time, with Meta’s review status, whether each can be sent right now (sendable) and, for a rejected one, Meta’s reason. Outside the 24-hour customer service window only an approved template can be sent. Meta reviews every template, and a decision can take up to 24 hours, so one in review cannot be sent. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"category","type":"string","required":false,"description":"Only this category: marketing, utility or authentication."},{"name":"language","type":"string","required":false,"description":"Only this language, e.g. en_US."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."},{"name":"status","type":"string","required":false,"description":"Only templates in this review state, e.g. approved."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":193},{"name":"submit_template","title":"Submit a template for WhatsApp review","description":"Creates a new WhatsApp message template and sends it to Meta for review. This leaves Cosend: Meta reviews every template (a decision can take up to 24 hours), and a rejection counts against the WhatsApp account’s quality history. Each submission needs a confirmed call: without confirmation_token the call is a preview that returns what would happen and a token for a person to approve; called again with that token, it submits. Ten a day per workspace. The categories: marketing makes people aware of the business, its offers and sales; utility follows up on something the customer did or asked for (an order, a booking) and may not promote anything, so an order update with a discount in it is marketing; authentication is a one-time code. A wrong category is moved or rejected by Meta. Meta’s answer shows in the template’s review status. It sends no message to anyone.","inputs":[{"name":"authentication","type":null,"required":false,"description":"An authentication template, in Meta's shape, in place of components and language: {\"languages\": [\"fr\", \"en_US\"], \"add_security_recommendation\": true, \"code_expiration_minutes\": 10, \"delivery\": {\"type…"},{"name":"category","type":"string","required":true,"description":null},{"name":"components","type":"array","required":false,"description":"Meta's components; required on every category but authentication, which takes authentication instead. A HEADER carries its format (TEXT, IMAGE, VIDEO, DOCUMENT or LOCATION), and a header without one…"},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"connection_id","type":"string","required":true,"description":null},{"name":"display_name","type":"string","required":false,"description":"The human name, free text (e.g. \"Order shipped\"). When name is left out, the system name is generated from it: lowercase, accents dropped, every other run of characters an underscore, at most 512 cha…"},{"name":"example_values","type":"object","required":false,"description":"A sample value for every variable in the TEXT header and the body, keyed per component by the name between the braces: {\"body\": {\"1\": \"Pablo\", \"2\": \"860198-230332\"}} or {\"body\": {\"first_name\": \"Pablo…"},{"name":"language","type":"string","required":false,"description":"The language, e.g. \"en_US\". Required on every category but authentication, which takes authentication.languages instead."},{"name":"name","type":"string","required":false,"description":"The system name, used as given. Optional: leave it out and it is generated from display_name. Give it to add a language to an existing template. One of name and display_name is required."},{"name":"parameter_format","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":859},{"name":"list_automations","title":"List automations","description":"Lists this workspace’s automations, one page at a time, with each one’s status, the version that is live, and today’s runs and failures. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":94},{"name":"validate_automation","title":"Check an automation","description":"Checks an automation document (ir) with Cosend’s compiler and returns its full report: every error with a JSON pointer into the document and, where one exists, a fix that can be applied. Nothing is written and nothing is deployed. id is the automation the draft belongs to; a brand-new automation gets its id when it is first saved, and saving checks the document the same way. It needs the automations:write permission because it is the authoring tool, though it changes nothing.","inputs":[{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"ir","type":"object","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":129},{"name":"list_automation_building_blocks","title":"List automation building blocks","description":"Lists what a custom automation on one WhatsApp number can be built from: each thing it can start on, with the settings it takes and the conditions it can start on; each step it can take, with the inputs it takes and what it returns; each integration working for that number, with its actions and their inputs; and the JSON Schema of the automation document, with the operators and functions a condition is written in. Only what the workspace’s plan includes and the number’s working integrations allow is listed. Read-only: it runs nothing and changes nothing.","inputs":[{"name":"connection_id","type":"string","required":true,"description":"The WhatsApp number (connection id) the automation is for: only what can be built and run on it is listed."}],"outputs":[{"name":"blocks","type":"array","required":true,"description":null},{"name":"document_schema","type":"object","required":false,"description":"The JSON Schema of an automation document (`ir_version` 1.0): what it starts on, its steps (actions, conditions, branches, loops, waits) and the expressions a condition is written in, each operator a…"},{"name":"integrations","type":"array","required":true,"description":"Every integration that has actions, with them: what a “Call an integration” step can name as its `integration` and `action`, and what each takes and answers."},{"name":"object","type":"string","required":true,"description":null},{"name":"triggers","type":"array","required":true,"description":null},{"name":"version","type":"string","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":156},{"name":"create_custom_automation","title":"Create a custom automation","description":"Creates a new automation on one WhatsApp number from an automation document (ir) written in full, as Cosend’s automation editor saves one: what it starts on, its steps and its limits, in the document schema that ir_version names. What a document can use on a number, each trigger, step and integration action with what it takes, and that schema itself, are in the read-only list of automation building blocks for the number. The document is checked as it is saved; one that does not pass is refused with each failing path as a JSON pointer. A “Run a script” step runs TypeScript written in the step, in a sandbox with no network and nothing imported; an outside address is reached only by a step that calls an allowlisted URL. A document marked as made from a recipe (meta.created_by \"recipe\") is refused: a recipe is set up and changed with its own tools. slug, name and connection_id name it and its number. It is created switched off: saving it runs nothing and sends nothing, and it acts only once it is deployed and switched on, each of which names every action its steps take. Its runs count against the plan’s allowance as every automation’s do. Each call needs confirming: without confirmation_token it changes nothing and returns a preview naming every action the document’s steps take, and a token for a person to approve; called again with that token, it saves. Returns the automation, switched off.","inputs":[{"name":"change_note","type":"string","required":false,"description":null},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"connection_id","type":"string","required":true,"description":"The WhatsApp number (connection id) this automation belongs to: its triggers come from it, its messages go from it, and its templates are read on it. Required, and it cannot be moved afterwards. The…"},{"name":"description","type":null,"required":false,"description":null},{"name":"ir","type":"object","required":true,"description":"The automation’s flow document (the IR), as a JSON object. `ir_version` selects the document schema Cosend validates it against. A document that does not match is refused with `automation_invalid`, w…"},{"name":"name","type":"string","required":true,"description":null},{"name":"slug","type":"string","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":515},{"name":"update_custom_automation","title":"Save a new version of an automation","description":"Saves a new version of one automation, named by id, from an automation document (ir) written in full, as Cosend’s automation editor saves one: what it starts on, its steps and its limits, in the document schema that ir_version names. What a document can use on a number, each trigger, step and integration action with what it takes, and that schema itself, are in the read-only list of automation building blocks for the number. The document is checked as it is saved; one that does not pass is refused with each failing path as a JSON pointer. A “Run a script” step runs TypeScript written in the step, in a sandbox with no network and nothing imported; an outside address is reached only by a step that calls an allowlisted URL. A document marked as made from a recipe (meta.created_by \"recipe\") is refused: a recipe is set up and changed with its own tools. The automation keeps running the version it ran until the new one is deployed and switched on. Each call needs confirming: without confirmation_token it changes nothing and returns a preview naming every action the document’s steps take, and a token for a person to approve; called again with that token, it saves. Returns the new version.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"ir","type":"object","required":true,"description":"The automation’s flow document (the IR), as a JSON object. `ir_version` selects the document schema Cosend validates it against. A document that does not match is refused with `automation_invalid`, w…"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":381},{"name":"deploy_automation","title":"Deploy an automation","description":"Compiles one version of an automation, runs Cosend’s safety checks on it and stores the result, so it can be switched on. It does not switch the automation on, and nothing is sent. version_id is the version; left out, the newest. actions names every action the version’s steps take, and those of a second automation set up with it, from the list in the schema (an automation’s versions list theirs as actions); a list that leaves one out or names another is refused, with the right list. The preview refuses that list as the call would, and gives no token. confirm_actions names, one by one, each destructive or money-moving action the person approved; one left unnamed is refused by name. Each call needs confirming: without confirmation_token it changes nothing and returns a preview and a token for a person to approve; called again with that token, it deploys. A confirmed deploy that fails to compile uses up the confirmation.","inputs":[{"name":"actions","type":"array","required":true,"description":"Every action the automation’s steps take, and those of a second automation set up with it, each once: what a person approves it doing. A list that leaves one out, or names one the steps do not take,…"},{"name":"confirm_actions","type":"array","required":false,"description":null},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"version_id","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":350},{"name":"switch_on_automation","title":"Switch an automation on","description":"Switches one automation on, running the version named (version_id), older or newer, got ready first if it never was; left out, the newest, which deploy_automation gets ready first. A version with a step that has to be confirmed by name is got ready with deploy_automation and confirm_actions first. From then on it acts on its own whenever what it starts on happens, and its steps run as they are built, which can include WhatsApp messages to customers. A recipe set up with a second automation switches on with it. actions names every action the version’s steps take, and the second automation’s, from the list in the schema (an automation’s versions list theirs as actions); a list that leaves one out or names another is refused, with the right list. The preview refuses that list as the call would, and gives no token. Each call needs confirming: without confirmation_token it changes nothing and returns a preview and a token for a person to approve; called again with that token, it switches it on.","inputs":[{"name":"actions","type":"array","required":true,"description":"Every action the automation’s steps take, and those of a second automation set up with it, each once: what a person approves it doing. A list that leaves one out, or names one the steps do not take,…"},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"version_id","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":358},{"name":"switch_off_automation","title":"Switch an automation off","description":"Switches one automation off at once, so it starts on nothing from then on. It needs no confirmation, so it works as an emergency stop. Messages it already sent stay sent. A recipe set up with a second automation switches off with it. Returns the automation.","inputs":[{"name":"id","type":"string","required":true,"description":"The id in the resource path."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":77},{"name":"set_up_ai_receptionist","title":"Set up “AI receptionist”","description":"Sets up Cosend’s “AI receptionist” automation on one WhatsApp number: Answers your customers on WhatsApp from what you teach it, and passes a chat to you when needed. Its settings are this recipe’s own, as its set-up form in Cosend asks them; a setting left out takes its default. It is set up switched off, and acts only once it is switched on. The same recipe is set up once on each number, or once per source when it asks for one. The preview refuses a second one as the save would, and gives no token. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the automation, switched off.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"connection_id","type":"string","required":true,"description":"The WhatsApp number (connection id) this automation belongs to: its triggers come from it, its messages go from it, and its templates are read on it. Required, and it cannot be moved afterwards. The…"},{"name":"name","type":"string","required":false,"description":"Its name in Cosend. Left out, it takes the recipe’s name."},{"name":"settings","type":"object","required":true,"description":"The recipe’s settings, as its set-up form asks them. A setting left out takes its default; a setting with no default is needed."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":361},{"name":"set_up_order_confirmation","title":"Set up “Order confirmation”","description":"Sets up Cosend’s “Order confirmation” automation on one WhatsApp number: When a customer pays in your shop, they get a WhatsApp message with the order number and total. Its settings are this recipe’s own, as its set-up form in Cosend asks them; a setting left out takes its default. It is set up switched off, and acts only once it is switched on. The same recipe is set up once on each number, or once per source when it asks for one. The preview refuses a second one as the save would, and gives no token. It needs woocommerce connected to the workspace first (by integration key). Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the automation, switched off.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"connection_id","type":"string","required":true,"description":"The WhatsApp number (connection id) this automation belongs to: its triggers come from it, its messages go from it, and its templates are read on it. Required, and it cannot be moved afterwards. The…"},{"name":"name","type":"string","required":false,"description":"Its name in Cosend. Left out, it takes the recipe’s name."},{"name":"settings","type":"object","required":true,"description":"The recipe’s settings, as its set-up form asks them. A setting left out takes its default; a setting with no default is needed."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":373},{"name":"set_up_order_updates","title":"Set up “Shipping and cancellation updates”","description":"Sets up Cosend’s “Shipping and cancellation updates” automation on one WhatsApp number: Customers get a WhatsApp message with their tracking when an order ships, and another if it is cancelled. Its settings are this recipe’s own, as its set-up form in Cosend asks them; a setting left out takes its default. It is set up switched off, and acts only once it is switched on. The same recipe is set up once on each number, or once per source when it asks for one. The preview refuses a second one as the save would, and gives no token. It needs woocommerce connected to the workspace first (by integration key). Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the automation, switched off.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"connection_id","type":"string","required":true,"description":"The WhatsApp number (connection id) this automation belongs to: its triggers come from it, its messages go from it, and its templates are read on it. Required, and it cannot be moved afterwards. The…"},{"name":"name","type":"string","required":false,"description":"Its name in Cosend. Left out, it takes the recipe’s name."},{"name":"settings","type":"object","required":true,"description":"The recipe’s settings, as its set-up form asks them. A setting left out takes its default; a setting with no default is needed."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":375},{"name":"set_up_lead_capture","title":"Set up “Lead capture from ads”","description":"Sets up Cosend’s “Lead capture from ads” automation on one WhatsApp number: People who message you from an ad answer your questions one at a time, and you get their answers. Its settings are this recipe’s own, as its set-up form in Cosend asks them; a setting left out takes its default. It is set up switched off, and acts only once it is switched on. The same recipe is set up once on each number, or once per source when it asks for one. The preview refuses a second one as the save would, and gives no token. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the automation, switched off.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"connection_id","type":"string","required":true,"description":"The WhatsApp number (connection id) this automation belongs to: its triggers come from it, its messages go from it, and its templates are read on it. Required, and it cannot be moved afterwards. The…"},{"name":"name","type":"string","required":false,"description":"Its name in Cosend. Left out, it takes the recipe’s name."},{"name":"settings","type":"object","required":true,"description":"The recipe’s settings, as its set-up form asks them. A setting left out takes its default; a setting with no default is needed."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":362},{"name":"set_up_quote_intake","title":"Set up “Quote requests”","description":"Sets up Cosend’s “Quote requests” automation on one WhatsApp number: Customers who ask for a quote answer your questions, then the chat comes to you with their answers. Its settings are this recipe’s own, as its set-up form in Cosend asks them; a setting left out takes its default. It is set up switched off, and acts only once it is switched on. The same recipe is set up once on each number, or once per source when it asks for one. The preview refuses a second one as the save would, and gives no token. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the automation, switched off.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"connection_id","type":"string","required":true,"description":"The WhatsApp number (connection id) this automation belongs to: its triggers come from it, its messages go from it, and its templates are read on it. Required, and it cannot be moved afterwards. The…"},{"name":"name","type":"string","required":false,"description":"Its name in Cosend. Left out, it takes the recipe’s name."},{"name":"settings","type":"object","required":true,"description":"The recipe’s settings, as its set-up form asks them. A setting left out takes its default; a setting with no default is needed."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":359},{"name":"set_up_appointment_reminder","title":"Set up “Appointment reminder”","description":"Sets up Cosend’s “Appointment reminder” automation on one WhatsApp number: Customers get a reminder before each booking, and you choose what Confirm, Reschedule and a typed reply do. Its settings are this recipe’s own, as its set-up form in Cosend asks them; a setting left out takes its default. It is set up switched off, and acts only once it is switched on. The same recipe is set up once on each number, or once per source when it asks for one. The preview refuses a second one as the save would, and gives no token. It needs google_calendar or microsoft_calendar or calendly or cal_com or bokun connected to the workspace first (by integration key). Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the automation, switched off.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"connection_id","type":"string","required":true,"description":"The WhatsApp number (connection id) this automation belongs to: its triggers come from it, its messages go from it, and its templates are read on it. Required, and it cannot be moved afterwards. The…"},{"name":"name","type":"string","required":false,"description":"Its name in Cosend. Left out, it takes the recipe’s name."},{"name":"settings","type":"object","required":true,"description":"The recipe’s settings, as its set-up form asks them. A setting left out takes its default; a setting with no default is needed."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":388},{"name":"set_up_welcome_menu","title":"Set up “Welcome and away menu”","description":"Sets up Cosend’s “Welcome and away menu” automation on one WhatsApp number: Greets new customers, and anyone who writes while you are closed, with buttons for quick answers or a person. Its settings are this recipe’s own, as its set-up form in Cosend asks them; a setting left out takes its default. It is set up switched off, and acts only once it is switched on. The same recipe is set up once on each number, or once per source when it asks for one. The preview refuses a second one as the save would, and gives no token. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the automation, switched off.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"connection_id","type":"string","required":true,"description":"The WhatsApp number (connection id) this automation belongs to: its triggers come from it, its messages go from it, and its templates are read on it. Required, and it cannot be moved afterwards. The…"},{"name":"name","type":"string","required":false,"description":"Its name in Cosend. Left out, it takes the recipe’s name."},{"name":"settings","type":"object","required":true,"description":"The recipe’s settings, as its set-up form asks them. A setting left out takes its default; a setting with no default is needed."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":364},{"name":"set_up_payment_reminder","title":"Set up “Payment reminder”","description":"Sets up Cosend’s “Payment reminder” automation on one WhatsApp number: Customers get WhatsApp reminders before and after an invoice in your Google Sheet is due, until you mark it paid. Its settings are this recipe’s own, as its set-up form in Cosend asks them; a setting left out takes its default. It is set up switched off, and acts only once it is switched on. The same recipe is set up once on each number, or once per source when it asks for one. The preview refuses a second one as the save would, and gives no token. It needs google_sheets connected to the workspace first (by integration key). Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the automation, switched off.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"connection_id","type":"string","required":true,"description":"The WhatsApp number (connection id) this automation belongs to: its triggers come from it, its messages go from it, and its templates are read on it. Required, and it cannot be moved afterwards. The…"},{"name":"name","type":"string","required":false,"description":"Its name in Cosend. Left out, it takes the recipe’s name."},{"name":"settings","type":"object","required":true,"description":"The recipe’s settings, as its set-up form asks them. A setting left out takes its default; a setting with no default is needed."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":377},{"name":"set_up_review_request","title":"Set up “Review request”","description":"Sets up Cosend’s “Review request” automation on one WhatsApp number: Tag a customer when the job is done, and a few hours later they get your request for a review. Its settings are this recipe’s own, as its set-up form in Cosend asks them; a setting left out takes its default. It is set up switched off, and acts only once it is switched on. The same recipe is set up once on each number, or once per source when it asks for one. The preview refuses a second one as the save would, and gives no token. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the automation, switched off.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"connection_id","type":"string","required":true,"description":"The WhatsApp number (connection id) this automation belongs to: its triggers come from it, its messages go from it, and its templates are read on it. Required, and it cannot be moved afterwards. The…"},{"name":"name","type":"string","required":false,"description":"Its name in Cosend. Left out, it takes the recipe’s name."},{"name":"settings","type":"object","required":true,"description":"The recipe’s settings, as its set-up form asks them. A setting left out takes its default; a setting with no default is needed."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":360},{"name":"set_up_missed_call_text_back","title":"Set up “Missed call text-back”","description":"Sets up Cosend’s “Missed call text-back” automation on one WhatsApp number: When a customer calls your WhatsApp number and nobody picks up, they get a message from you straight away. Its settings are this recipe’s own, as its set-up form in Cosend asks them; a setting left out takes its default. It is set up switched off, and acts only once it is switched on. The same recipe is set up once on each number, or once per source when it asks for one. The preview refuses a second one as the save would, and gives no token. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the automation, switched off.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"connection_id","type":"string","required":true,"description":"The WhatsApp number (connection id) this automation belongs to: its triggers come from it, its messages go from it, and its templates are read on it. Required, and it cannot be moved afterwards. The…"},{"name":"name","type":"string","required":false,"description":"Its name in Cosend. Left out, it takes the recipe’s name."},{"name":"settings","type":"object","required":true,"description":"The recipe’s settings, as its set-up form asks them. A setting left out takes its default; a setting with no default is needed."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":366},{"name":"set_up_accurate_warehouse_arrival","title":"Set up “Warehouse arrival message”","description":"Sets up Cosend’s “Warehouse arrival message” automation on one WhatsApp number: When an Accurate shipment reaches the warehouse, its receiver gets one WhatsApp message with the shipment’s details. Its settings are this recipe’s own, as its set-up form in Cosend asks them; a setting left out takes its default. It is set up switched off, and acts only once it is switched on. The same recipe is set up once on each number, or once per source when it asks for one. The preview refuses a second one as the save would, and gives no token. It needs accurate, and http connected to the workspace first (by integration key). Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the automation, switched off.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"connection_id","type":"string","required":true,"description":"The WhatsApp number (connection id) this automation belongs to: its triggers come from it, its messages go from it, and its templates are read on it. Required, and it cannot be moved afterwards. The…"},{"name":"name","type":"string","required":false,"description":"Its name in Cosend. Left out, it takes the recipe’s name."},{"name":"settings","type":"object","required":true,"description":"The recipe’s settings, as its set-up form asks them. A setting left out takes its default; a setting with no default is needed."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":381},{"name":"update_ai_receptionist","title":"Change “AI receptionist” settings","description":"Changes the settings of an automation set up from Cosend’s “AI receptionist” recipe, named by id, as its settings page in Cosend does: the settings given replace their values, the rest keep theirs, and the result is saved as a new version. If the automation is switched on, the new settings go live with the save, or the save is refused in words and it keeps running what it ran; if it is off, they wait for it to be switched on. An automation from another recipe, or one written by hand, is refused. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the new version.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The automation set up from the “AI receptionist” recipe whose settings change."},{"name":"settings","type":"object","required":true,"description":"The settings to change, as the recipe’s settings form asks them. A setting left out keeps the value it has."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":271},{"name":"update_order_confirmation","title":"Change “Order confirmation” settings","description":"Changes the settings of an automation set up from Cosend’s “Order confirmation” recipe, named by id, as its settings page in Cosend does: the settings given replace their values, the rest keep theirs, and the result is saved as a new version. If the automation is switched on, the new settings go live with the save, or the save is refused in words and it keeps running what it ran; if it is off, they wait for it to be switched on. An automation from another recipe, or one written by hand, is refused. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the new version.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The automation set up from the “Order confirmation” recipe whose settings change."},{"name":"settings","type":"object","required":true,"description":"The settings to change, as the recipe’s settings form asks them. A setting left out keeps the value it has."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":269},{"name":"update_order_updates","title":"Change “Shipping and cancellation updates” settings","description":"Changes the settings of an automation set up from Cosend’s “Shipping and cancellation updates” recipe, named by id, as its settings page in Cosend does: the settings given replace their values, the rest keep theirs, and the result is saved as a new version. If the automation is switched on, the new settings go live with the save, or the save is refused in words and it keeps running what it ran; if it is off, they wait for it to be switched on. An automation from another recipe, or one written by hand, is refused. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the new version.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The automation set up from the “Shipping and cancellation updates” recipe whose settings change."},{"name":"settings","type":"object","required":true,"description":"The settings to change, as the recipe’s settings form asks them. A setting left out keeps the value it has."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":273},{"name":"update_lead_capture","title":"Change “Lead capture from ads” settings","description":"Changes the settings of an automation set up from Cosend’s “Lead capture from ads” recipe, named by id, as its settings page in Cosend does: the settings given replace their values, the rest keep theirs, and the result is saved as a new version. If the automation is switched on, the new settings go live with the save, or the save is refused in words and it keeps running what it ran; if it is off, they wait for it to be switched on. An automation from another recipe, or one written by hand, is refused. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the new version.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The automation set up from the “Lead capture from ads” recipe whose settings change."},{"name":"settings","type":"object","required":true,"description":"The settings to change, as the recipe’s settings form asks them. A setting left out keeps the value it has."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":274},{"name":"update_quote_intake","title":"Change “Quote requests” settings","description":"Changes the settings of an automation set up from Cosend’s “Quote requests” recipe, named by id, as its settings page in Cosend does: the settings given replace their values, the rest keep theirs, and the result is saved as a new version. If the automation is switched on, the new settings go live with the save, or the save is refused in words and it keeps running what it ran; if it is off, they wait for it to be switched on. An automation from another recipe, or one written by hand, is refused. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the new version.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The automation set up from the “Quote requests” recipe whose settings change."},{"name":"settings","type":"object","required":true,"description":"The settings to change, as the recipe’s settings form asks them. A setting left out keeps the value it has."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":270},{"name":"update_appointment_reminder","title":"Change “Appointment reminder” settings","description":"Changes the settings of an automation set up from Cosend’s “Appointment reminder” recipe, named by id, as its settings page in Cosend does: the settings given replace their values, the rest keep theirs, and the result is saved as a new version. If the automation is switched on, the new settings go live with the save, or the save is refused in words and it keeps running what it ran; if it is off, they wait for it to be switched on. An automation from another recipe, or one written by hand, is refused. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the new version.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The automation set up from the “Appointment reminder” recipe whose settings change."},{"name":"settings","type":"object","required":true,"description":"The settings to change, as the recipe’s settings form asks them. A setting left out keeps the value it has."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":271},{"name":"update_welcome_menu","title":"Change “Welcome and away menu” settings","description":"Changes the settings of an automation set up from Cosend’s “Welcome and away menu” recipe, named by id, as its settings page in Cosend does: the settings given replace their values, the rest keep theirs, and the result is saved as a new version. If the automation is switched on, the new settings go live with the save, or the save is refused in words and it keeps running what it ran; if it is off, they wait for it to be switched on. An automation from another recipe, or one written by hand, is refused. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the new version.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The automation set up from the “Welcome and away menu” recipe whose settings change."},{"name":"settings","type":"object","required":true,"description":"The settings to change, as the recipe’s settings form asks them. A setting left out keeps the value it has."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":274},{"name":"update_payment_reminder","title":"Change “Payment reminder” settings","description":"Changes the settings of an automation set up from Cosend’s “Payment reminder” recipe, named by id, as its settings page in Cosend does: the settings given replace their values, the rest keep theirs, and the result is saved as a new version. If the automation is switched on, the new settings go live with the save, or the save is refused in words and it keeps running what it ran; if it is off, they wait for it to be switched on. An automation from another recipe, or one written by hand, is refused. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the new version.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The automation set up from the “Payment reminder” recipe whose settings change."},{"name":"settings","type":"object","required":true,"description":"The settings to change, as the recipe’s settings form asks them. A setting left out keeps the value it has."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":270},{"name":"update_review_request","title":"Change “Review request” settings","description":"Changes the settings of an automation set up from Cosend’s “Review request” recipe, named by id, as its settings page in Cosend does: the settings given replace their values, the rest keep theirs, and the result is saved as a new version. If the automation is switched on, the new settings go live with the save, or the save is refused in words and it keeps running what it ran; if it is off, they wait for it to be switched on. An automation from another recipe, or one written by hand, is refused. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the new version.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The automation set up from the “Review request” recipe whose settings change."},{"name":"settings","type":"object","required":true,"description":"The settings to change, as the recipe’s settings form asks them. A setting left out keeps the value it has."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":269},{"name":"update_missed_call_text_back","title":"Change “Missed call text-back” settings","description":"Changes the settings of an automation set up from Cosend’s “Missed call text-back” recipe, named by id, as its settings page in Cosend does: the settings given replace their values, the rest keep theirs, and the result is saved as a new version. If the automation is switched on, the new settings go live with the save, or the save is refused in words and it keeps running what it ran; if it is off, they wait for it to be switched on. An automation from another recipe, or one written by hand, is refused. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the new version.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The automation set up from the “Missed call text-back” recipe whose settings change."},{"name":"settings","type":"object","required":true,"description":"The settings to change, as the recipe’s settings form asks them. A setting left out keeps the value it has."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":278},{"name":"update_accurate_warehouse_arrival","title":"Change “Warehouse arrival message” settings","description":"Changes the settings of an automation set up from Cosend’s “Warehouse arrival message” recipe, named by id, as its settings page in Cosend does: the settings given replace their values, the rest keep theirs, and the result is saved as a new version. If the automation is switched on, the new settings go live with the save, or the save is refused in words and it keeps running what it ran; if it is off, they wait for it to be switched on. An automation from another recipe, or one written by hand, is refused. Each call needs confirming: without confirmation_token it changes nothing and returns a preview with the settings as Cosend filled them in and its check of them, and a token for a person to approve; called again with that token, it saves. Returns the new version.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The automation set up from the “Warehouse arrival message” recipe whose settings change."},{"name":"settings","type":"object","required":true,"description":"The settings to change, as the recipe’s settings form asks them. A setting left out keeps the value it has."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":276},{"name":"list_runs","title":"List automation runs","description":"Lists automation runs, newest first, one page at a time, with each run’s status, how long it took and what it sent. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"automation_id","type":"string","required":false,"description":"Only runs of this automation."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."},{"name":"status","type":"string","required":false,"description":"Only runs in this state: queued, running, waiting, success, failure, cancelled, timeout, skipped or unknown."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":131},{"name":"get_run","title":"Read an automation run","description":"Reads one automation run and its step-by-step trace: under run, the run’s status, timings, what it sent and why it failed; under steps, each step it took with its status and error, one page at a time. Text inside a run can quote what a customer wrote, and comes back marked untrusted. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":139},{"name":"get_usage","title":"See plan usage","description":"Reports this workspace’s usage for one billing period against what its plan includes. Read-only.","inputs":[{"name":"period","type":"string","required":false,"description":"Which billing period. Omit for the current one."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":43},{"name":"resolve_conversation","title":"Mark a conversation Done","description":"Marks one conversation Done, as the Done button in the Cosend Inbox does. Nothing is sent to anyone and no automation starts. Afterwards no person holds the conversation (the person, the assignee, the priority and any hand-over are cleared) and every automation on that WhatsApp number treats the customer’s next message as a first message: the welcome menu greets again, an unfinished question flow starts over, and the AI assistant begins a new AI conversation, which counts as one more AI conversation on the plan. The message history stays. The chat stays quiet until the customer writes again. It is refused for a credential with no person behind it.","inputs":[{"name":"id","type":"string","required":true,"description":"The id in the resource path."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":152},{"name":"create_setup_link","title":"Make a set-up link","description":"Makes a link for the person in this chat to open in their own browser, signed in to Cosend, to do one set-up step only they can do there, and returns its url. It works for 30 minutes and only for them, and carries no password or key. kind connect_number connects a WhatsApp number; reconnect_number needs connection_id and runs Meta’s flow again for that number; connect_integrations needs connectors (each integration by its Cosend key, as list_connectors gives them) and completes when every one has an account, and with account_id (and that account’s one connector) the person types a new key for an account that already exists; pick_google_file needs account_id, a Google account, and opens Google’s file picker for it so the person can choose spreadsheets Cosend may open; upgrade needs plan, the plan to buy; payment_method adds a card. The person does the step themselves on the page: they connect the number in Meta’s window, sign in to the integration or type its key, choose files in Google’s picker, pay in Stripe’s Checkout, or add the card. It cannot be done for them. A new link of the same kind cancels the workspace’s open one, whoever made it.","inputs":[{"name":"account_id","type":"string","required":false,"description":"The connected Google account whose file picker opens, by its connector account id. The person chooses the spreadsheets Cosend may open; the link completes when the picker was opened."},{"name":"connection_id","type":"string","required":false,"description":"The WhatsApp number to reconnect, by its connection id. The person runs Meta’s flow again for it, and the link completes when that number is connected."},{"name":"connectors","type":"array","required":false,"description":"The integrations the person signs in to, by key from GET /v1/connectors. The link completes when every one of them has an account."},{"name":"kind","type":"string","required":true,"description":null},{"name":"plan","type":"string","required":false,"description":"The plan to buy, by code from GET /v1/billing/plans. Only for a workspace with no paid subscription, and only to a higher plan."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":425},{"name":"check_setup_link","title":"Check a set-up link","description":"Reads a set-up link’s status. status open means the step is not done; completed means it has, and result says what was set up; expired means its 30 minutes passed; cancelled means it was cancelled or replaced by a newer one. For connect_integrations, result.connector_accounts lists each account saved; when the workspace has several WhatsApp numbers an account is on none of them until it is added to a number (the Integrations page in Cosend, or the integration account tool’s add_number). For reconnect_number, result names the connection and its number once Meta’s flow finished; for pick_google_file, completed means Google’s picker was opened for the account, and the account’s spreadsheet list shows what was chosen. Only the person who asked for the link can read it. Read-only.","inputs":[{"name":"id","type":"string","required":true,"description":"The id in the resource path."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":184},{"name":"cancel_setup_link","title":"Cancel a set-up link","description":"Cancels an open set-up link so its page stops working, for example when the person changed their mind or the link asks for the wrong thing. A link already completed, expired or cancelled is refused, and nothing a link set up is undone. Only the person who asked for it can cancel it.","inputs":[{"name":"id","type":"string","required":true,"description":"The id in the resource path."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":83},{"name":"whatsapp_link","title":"Make a WhatsApp chat link","description":"Makes a wa.me chat link and its QR code (an SVG image) for a WhatsApp number, with an opening message if one is given. country is the two-letter ISO code and number is the number exactly as it is typed in that country (as written at home, with +, with 00 or with the country code in front); a number of another country is refused. It sends nothing to anyone.","inputs":[{"name":"country","type":"string","required":true,"description":"The country the number belongs to, as its two-letter ISO code: \"GB\", \"US\", \"DE\". A number of another country is refused."},{"name":"message","type":"string","required":false,"description":"The message the chat starts with, at most 500 characters. Left out or blank, the link opens an empty chat."},{"name":"number","type":"string","required":true,"description":"The WhatsApp number as people type it: as written at home (07700 900123), with + (+44 7700 900123), with 00 (0044 7700 900123) or with the country code in front (44 7700 900123). Spaces, dashes, brac…"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":240},{"name":"template_check","title":"Check a template before Meta reviews it","description":"Checks a WhatsApp message template (category, language, components and example values, as Meta takes them) against Meta’s rules, which are errors, and the warning signals Meta names, which are warnings; each problem says where it is and what to change. The verdict is fix_first, warnings or ready, and ready is not an approval: Meta still reviews every template itself. Nothing is submitted.","inputs":[{"name":"authentication","type":null,"required":false,"description":"An authentication template, in Meta's shape, in place of components and language: {\"languages\": [\"fr\", \"en_US\"], \"add_security_recommendation\": true, \"code_expiration_minutes\": 10, \"delivery\": {\"type…"},{"name":"category","type":"string","required":true,"description":null},{"name":"components","type":"array","required":false,"description":"Meta's components, as POST /v1/templates takes them; required on every category but authentication, which takes authentication instead."},{"name":"example_values","type":"object","required":false,"description":"A sample value for every variable in the TEXT header and the body, keyed per component by the name between the braces: {\"body\": {\"1\": \"Pablo\", \"2\": \"860198-230332\"}} or {\"body\": {\"first_name\": \"Pablo…"},{"name":"language","type":"string","required":false,"description":"The language, e.g. \"en_US\". Required on every category but authentication, which takes authentication.languages instead."},{"name":"parameter_format","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":426},{"name":"message_cost","title":"See what a WhatsApp message costs","description":"Returns Meta’s list price for one delivered WhatsApp message in a country, for each category (marketing, utility, authentication, service), in one of Meta’s 16 rate-card currencies, with the day the rates took effect. These are Meta’s list prices: a business’s bill may differ, and the notes say what changes it.","inputs":[{"name":"country","type":"string","required":true,"description":"The country the messages go to, as its two-letter ISO code, e.g. GB or DE."},{"name":"currency","type":"string","required":true,"description":"One of Meta’s 16 rate-card currencies, e.g. USD, EUR, GBP or INR."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":130},{"name":"get_conversation","title":"Open a conversation","description":"Reads one conversation, named by id. view conversation returns the chat itself: its contact and newest message, its state, who it is assigned to, its labels, priority and snooze, the hand-over summary when a person is needed, who holds the reply lock, and the 24-hour customer service window (open or closed, and when it closes). view activity returns the chat’s activity feed one page at a time: hand-overs, assignments, labels, Done and reopened, optionally only the kinds named in kind. Names, message text and hand-over summaries were written by people outside this business, or from what they wrote, and come back marked untrusted. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"kind","type":"array","required":false,"description":"Activity view only: keep only these kinds of activity. Repeat for several."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."},{"name":"view","type":"string","required":true,"description":"conversation for the chat itself, with its window and who holds it; activity for its activity feed."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":256},{"name":"search_messages","title":"Search message text","description":"Searches the text of every message in the workspace, newest first, 20 hits to a page. Each hit has the message id, the conversation id and number it belongs to, when it was sent and a snippet of the matching text. A number whose messages go straight to the business’s own system, with no Cosend inbox, is left out. Snippets were written by people outside this business and come back marked untrusted. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"connection_id","type":"string","required":false,"description":"Only messages on this WhatsApp number."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."},{"name":"q","type":"string","required":true,"description":"The words to look for in message text."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":177},{"name":"get_message","title":"Open one message","description":"Reads one message, named by its msg_ id or by the WhatsApp message id (wamid): its type and content, direction, delivery status with the time of each step, who sent it, and any file, location, buttons or reactions it carries. Message text comes from people outside this business and comes back marked untrusted. Read-only.","inputs":[{"name":"id","type":"string","required":true,"description":"The id in the resource path."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":92},{"name":"get_media","title":"Open a file from a chat","description":"Reads one media file, named by its med_ id (a message’s media block carries it): its type, file name, size and state, and a signed link to download it that works for 15 minutes. File names come from people outside this business and come back marked untrusted. Read-only.","inputs":[{"name":"id","type":"string","required":true,"description":"The id in the resource path."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":83},{"name":"get_inbox_overview","title":"See the Inbox at a glance","description":"Reads the figures the Inbox and Home show, one part at a time. part counts returns how many chats are waiting for a person, assigned to the caller, unread, in all (Done and snoozed ones included), and have a 24-hour window closing within four hours, per number and in total, with the approvals waiting. part labels returns each label in use on each number with how many open chats carry it. part today returns today’s replies by who sent them (the assistant, people, the phone, automations) and the chats handed to a person, marked Done and opened, and the AI receptionist’s chats (handled, answered alone, handed over, as its page and Reports count them), in the workspace’s time zone. part week returns replies and new chats for each of the last 7 days. Read-only.","inputs":[{"name":"connection_id","type":"array","required":false,"description":"Only this WhatsApp number; repeat it for several. Omit for every number you can see."},{"name":"part","type":"string","required":true,"description":"counts for chats waiting, mine, unread and windows closing; labels for the labels in use; today for today’s replies by who sent them; week for the last 7 days."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":251},{"name":"mark_read","title":"Mark chats read","description":"Marks read, in one of three ways, with id naming a conversation (cosend, phone_thread) or a message (phone_message). where cosend clears the chat’s unread state for the whole workspace in Cosend; the customer’s phone stays as it was. where phone_thread tells WhatsApp the newest unread customer message was read, so the customer’s phone shows blue ticks on what they sent. where phone_message does the same for the one message named. The blue ticks reach a real person’s phone and are permanent.","inputs":[{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"where","type":"string","required":true,"description":"cosend to mark a chat read in Cosend only; phone_thread to show blue ticks for the chat’s unread messages on the customer’s phone; phone_message to show them for one message."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":172},{"name":"update_conversation","title":"Update a conversation","description":"Changes one conversation, named by id, by whichever of these are given: assignee_id (a member’s usr_ id; null takes the assignee off), snoozed_until (a time; null ends the snooze), labels (the whole list of labels, replacing the old one), priority, and state. state resolved marks the chat Done, as the Done button does: nobody holds it afterwards and every automation on that number treats the customer’s next message as a first message. The change stays inside Cosend, out of the customer’s view. Returns the conversation.","inputs":[{"name":"assignee_id","type":null,"required":false,"description":null},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"labels","type":"array","required":false,"description":null},{"name":"priority","type":"string","required":false,"description":null},{"name":"snoozed_until","type":null,"required":false,"description":null},{"name":"state","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":175},{"name":"bulk_update_conversations","title":"Update many conversations","description":"Applies one action to up to 100 conversations named in ids: resolve marks each Done, assign sets assignee_id (null takes it off), label adds labels_add and takes off labels_remove, priority sets priority, and read marks each read in Cosend. Each chat gets its own result, so one that is not found or that someone else is replying in is skipped with its reason while the rest go through. Each action needs a confirmed call: without confirmation_token the call is a preview that returns what would happen and a token for a person to approve; called again with that token, it acts. Every change stays inside Cosend, out of customers’ view.","inputs":[{"name":"action","type":"string","required":true,"description":null},{"name":"assignee_id","type":null,"required":false,"description":null},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"ids","type":"array","required":true,"description":null},{"name":"labels_add","type":"array","required":false,"description":null},{"name":"labels_remove","type":"array","required":false,"description":null},{"name":"priority","type":"string","required":false,"description":null},{"name":"read","type":"boolean","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":238},{"name":"take_over_conversation","title":"Hand a chat to a person","description":"Puts one conversation, named by id, in a person’s hands: control human means a person holds it and the AI assistant and automations stop answering in it; control pending_human marks it as waiting for a person to pick up. reason says why, and pause_bot_until holds the assistant back until a time. It hands the chat to a person; the chat stays with people from then on. The change stays inside Cosend, out of the customer’s view. Returns the conversation.","inputs":[{"name":"control","type":"string","required":true,"description":null},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"pause_bot_until","type":"string","required":false,"description":null},{"name":"reason","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":146},{"name":"ask_for_conversation","title":"Ask a teammate for a chat","description":"Asks the person who holds one conversation, named by id, in the Cosend Inbox to hand it over; reason is an optional note for them. They get a hand-over prompt: when they say yes, or do not answer within 60 seconds, the chat passes to the person this app acts for, and messages can be sent in it; when they say no, it stays theirs. This is the way into a chat someone else holds: every hand-over starts with asking its holder. A chat nobody holds, or one the person this app acts for already holds, is refused, as there is nothing to ask for and a message can be sent there as it is. Asking again while a request waits returns that request. Returns the request: its state (pending until answered), who holds the chat (held_by) and when it passes without an answer (expires_at). Whether it has passed shows in the conversation’s lock (held_by, can_i_send). The request stays inside Cosend, out of the customer’s view.","inputs":[{"name":"id","type":"string","required":true,"description":"The conversation to ask for."},{"name":"reason","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":238},{"name":"list_chat_notes","title":"Read the internal notes on a chat","description":"Lists the internal notes on one conversation, named by id, one page at a time, oldest first: each note’s body, its author, the members it mentions and when it was written or edited. The customer does not see notes. Notes can quote customers and come back marked untrusted. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":133},{"name":"chat_notes","title":"Add, edit or delete an internal note","description":"Writes the internal notes on one conversation, named by id, visible to the business’s team. action add writes a note (body, with mentions as a list of usr_ ids of members to notify). action edit changes a note’s body (noteId and body; only its author can). action delete removes a note (noteId; its author, an owner or an admin can). Each delete needs a confirmed call: without confirmation_token the call is a preview that returns what would happen and a token for a person to approve; called again with that token, it deletes. add and edit return the note, whose body can quote customers and comes back marked untrusted.","inputs":[{"name":"action","type":"string","required":true,"description":"add, edit or delete."},{"name":"body","type":"string","required":false,"description":null},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"mentions","type":"array","required":false,"description":null},{"name":"noteId","type":"string","required":false,"description":"The noteId in the resource path."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":240},{"name":"list_inbox_views","title":"Read the saved Inbox views","description":"Lists the saved views in the Inbox’s Views menu: the caller’s own views and every one shared with the workspace, each with its name, the conversation filters it applies and who sees it. Read-only.","inputs":[],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":52},{"name":"inbox_views","title":"Save, change or delete an Inbox view","description":"Writes the saved views in the Inbox’s Views menu: a name and the conversation filters it applies. action save makes a view (name, filters, and shared: private or workspace). action update (id) renames a view or changes its filters or who sees it; a shared view can be changed by its creator, an owner or an admin. action delete (id) removes a view, on the same terms. Each delete needs a confirmed call: without confirmation_token the call is a preview that returns what would happen and a token for a person to approve; called again with that token, it deletes.","inputs":[{"name":"action","type":"string","required":true,"description":"save, update or delete."},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"filters","type":"object","required":false,"description":null},{"name":"id","type":"string","required":false,"description":"The id in the resource path."},{"name":"name","type":"string","required":false,"description":null},{"name":"shared","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":220},{"name":"get_contact","title":"Open a contact","description":"Reads one contact, named by id (a ct_ id, an E.164 phone number or a BSUID), in one of four views. view contact returns the contact: names, phone number or BSUID, tags, attributes, time zone and whether it is blocked. view consent returns the consent state for marketing, utility and authentication, with the entry behind each (where it came from, when, who recorded it, the sentence the person agreed to) and Meta’s own marketing opt-out. view window returns whether a free-form message can be sent now and when the 24-hour customer service window closes. view chats returns this person’s conversation on each number you can see, newest first. Names, attributes and consent sentences come from outside this business and come back marked untrusted. Read-only.","inputs":[{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"view","type":"string","required":true,"description":"contact for the contact itself; consent for consent per category with its evidence; window for the messaging window; chats for this person’s chats on each number."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":220},{"name":"update_contact","title":"Edit a contact","description":"Changes one contact, named by id, by whichever of these are given: name (the name the business sets, which shows first; null goes back to the WhatsApp names; owners and admins only), attributes (field values by key), tags (the whole list, replacing the old one), locale, timezone, and is_blocked (true blocks the contact on their number so nothing is sent to them and their messages are not answered; false unblocks; owners and admins only). The change stays inside Cosend, out of the contact’s view. Returns the contact.","inputs":[{"name":"attributes","type":"object","required":false,"description":"Free-form values. PATCH replaces them whole; a POST for a contact that already exists writes the keys sent over its values and removes none. A key registered in /v1/contact-fields must hold a value o…"},{"name":"connection_id","type":"string","required":false,"description":null},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"is_blocked","type":"boolean","required":false,"description":null},{"name":"locale","type":null,"required":false,"description":null},{"name":"name","type":null,"required":false,"description":null},{"name":"profile_name","type":null,"required":false,"description":null},{"name":"tags","type":"array","required":false,"description":null},{"name":"timezone","type":null,"required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":335},{"name":"tag_contact","title":"Tag or untag a contact","description":"Adds tags to, or removes tags from, one contact, named by id, without touching the rest of its tags. action add leaves a tag the contact already has as it is; action remove skips a tag it does not have. tags is the list of tag names. The change stays inside Cosend. Returns the contact.","inputs":[{"name":"action","type":"string","required":true,"description":"add to put tags on the contact, remove to take them off."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"tags","type":"array","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":114},{"name":"delete_contact","title":"Delete a contact","description":"Deletes one contact, named by id. Without purge the contact and its chats drop out of lists, counts and the Inbox, and Cosend keeps their messages until a purge; if the person writes again, they become a new contact with a new chat. With purge true the contact and what Cosend holds about them are erased for good (an owner’s action, for a data-protection request). The deletion stays inside Cosend, out of the contact’s view. Each delete needs a confirmed call: without confirmation_token the call is a preview that names the contact and returns a token for a person to approve; called again with that token, it deletes.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"purge","type":"boolean","required":false,"description":"true to erase the contact for good, as a data-protection erasure does (owners only); omit to take the contact and its chats out of lists and the Inbox, with its messages kept."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":242},{"name":"merge_contacts","title":"Merge two contacts","description":"Merges two identities of one person (a phone number and a BSUID): the contact named by id keeps going, and the one named by from is folded into it and removed. It cannot be undone. Each merge needs a confirmed call: without confirmation_token the call is a preview that names both contacts and returns a token for a person to approve; called again with that token, it merges. Returns the contact that remains.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"from","type":"string","required":true,"description":null},{"name":"id","type":"string","required":true,"description":"The id in the resource path."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":157},{"name":"list_contact_fields","title":"Read the contact fields","description":"Lists the workspace’s contact fields, the keys a contact’s attributes can hold, one page at a time: each field’s key, label, type (text, number, date, boolean or choice), its choices, whether it is required, and how many contacts hold a value for it. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":120},{"name":"contact_fields","title":"Add, change or delete a contact field","description":"Writes the workspace’s contact fields: the keys a contact’s attributes can hold. action create adds one (key, label, type text, number, date, boolean or choice, choices for a choice field, required). action update (id) changes a field’s label, type, choices or required; its key stays. action delete (id) removes the field and every contact’s value for it. Creating, changing and deleting are for owners and admins. Each delete needs a confirmed call: without confirmation_token the call is a preview that returns what would happen and a token for a person to approve; called again with that token, it deletes.","inputs":[{"name":"action","type":"string","required":true,"description":"create, update or delete."},{"name":"choices","type":"array","required":false,"description":"A choice field's options, 1 to 100 of them, each once; none otherwise."},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":false,"description":"The id in the resource path."},{"name":"key","type":"string","required":false,"description":null},{"name":"label","type":"string","required":false,"description":null},{"name":"required","type":"boolean","required":false,"description":null},{"name":"type","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":260},{"name":"import_contacts","title":"Import contacts from a CSV","description":"Imports contacts from a CSV file for one WhatsApp number, in steps. step start uploads the file (connection_id; data_base64, or media_id of a text or CSV file already uploaded; file_name) and returns its id, columns, first rows and row count. step map (id) sets mapping (each column as phone, name, tags, locale, timezone, skip or field:key; name and tags may be on several columns), new_fields (fields the run adds to the workspace, each key, label, type and choices, for columns mapped to field:key), connection_id, and consent: the opt-in categories everyone in the file gave, the sentence they agreed to and who attests it. step check (id) reports what a run would do over the whole file: new, updated, invalid, duplicates, already opted out and consent recorded, and with details true the rows left out and five contacts as they will be (a phone typed without its country code takes the country of the number); it writes nothing. step run (id) imports in the background and returns at once; the import’s progress shows in the list of imports. Owners and admins run imports. Each run needs a confirmed call: without confirmation_token the call is a preview that shows the import, its mapping, its new fields and its consent, and returns a token for a person to approve; called again with that token, it runs. The import stays inside Cosend, out of the contacts’ view. File contents come from outside this business and come back marked untrusted.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"connection_id","type":"string","required":false,"description":null},{"name":"consent","type":null,"required":false,"description":null},{"name":"data_base64","type":"string","required":false,"description":"The CSV file, base64-encoded."},{"name":"details","type":"boolean","required":false,"description":"Also answer the rows that will not be imported (the first 100) and five contacts as the import will write them."},{"name":"file_name","type":"string","required":false,"description":null},{"name":"id","type":"string","required":false,"description":"The id in the resource path."},{"name":"mapping","type":"object","required":false,"description":null},{"name":"media_id","type":"string","required":false,"description":"A med_ id from POST /v1/media (text/plain or text/csv), instead of data_base64."},{"name":"new_fields","type":"array","required":false,"description":null},{"name":"step","type":"string","required":true,"description":"start to upload the file; map to set the columns, the number and the consent; check to see what a run would do; run to import."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":534},{"name":"list_contact_imports","title":"See contact imports","description":"Reads contact imports. Without id it lists the workspace’s imports, newest first, one page at a time (a member sees those for their own numbers). With id it returns that import: its state (draft, queued, running, completed or failed), the file, columns, mapping and consent, progress, and when finished the number imported and the rows that failed with the reason for each. File contents come from outside this business and come back marked untrusted. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"id","type":"string","required":false,"description":"The id in the resource path."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":168},{"name":"list_numbers","title":"List WhatsApp numbers","description":"Lists the WhatsApp numbers connected to this workspace, one page at a time, each with its id, status and health at a glance. The number ids it returns are what other tools take as connection_id. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."},{"name":"mode","type":"string","required":false,"description":"Only numbers connected this way: coexistence or cloud_api."},{"name":"status","type":"string","required":false,"description":"Only numbers in this state, e.g. active."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":137},{"name":"get_number","title":"Read one WhatsApp number","description":"Reads one WhatsApp number in one of four views. summary: its status, quality, limits and onboarding summary. import_progress: the progress of importing the number’s chat history. connect_steps and attempt_steps: an ordered list of the steps of connecting it, each with its state, time and outcome, which explains where a connect that stopped stopped. Read-only.","inputs":[{"name":"id","type":"string","required":true,"description":"The WhatsApp number (connection) id; for view attempt_steps, the connect attempt id."},{"name":"view","type":"string","required":true,"description":"summary for the number with its onboarding summary; import_progress for how far the chat-history import has come; connect_steps for the steps of how the number was connected, with their times and out…"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":168},{"name":"list_cosend_numbers","title":"List phone numbers from Cosend","description":"Reads the phone numbers from Cosend (bought through Cosend for WhatsApp) in one of two views. held: the numbers this workspace holds now or gave back in the last 12 months, with how many count toward the plan’s limit. Each has its id (cnm_…), its status (buying, verifying while WhatsApp’s code is awaited, ready, stopping until its last day in release_at, released), and whether WhatsApp pre-verified it; when it did not, preverify_error says why and preverify_retry_at says from when Cosend may ask WhatsApp for a new code on the same number. available: up to 10 local US or Canadian numbers that can be bought now, each with its phone_number, country, locality and region, which a purchase names exactly; owners and admins only. Read-only.","inputs":[{"name":"area_code","type":"string","required":false,"description":"For view available: a three-digit area code."},{"name":"contains","type":"string","required":false,"description":"For view available: 2 to 7 digits the number should contain."},{"name":"country","type":"string","required":false,"description":"For view available: US or CA."},{"name":"view","type":"string","required":true,"description":"held for the numbers this workspace has from Cosend; available for local numbers Cosend can get for it now, by country, area code and digits."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":272},{"name":"buy_cosend_number","title":"Buy a phone number from Cosend","description":"Buys one local US or Canadian phone number from Cosend for WhatsApp, named by its phone_number and country as the search of available numbers returned them (with its locality and region), and returns it as a Cosend number (cnm_…), usually verifying. It charges the workspace’s card, so it acts only on a confirmed call: without confirmation_token it buys nothing and returns a preview and a token for a person to approve. The preview shows the price of a number, its interval (month or year, as the plan is billed), when it renews and the amount charged today for the rest of the billing period; the price, interval and renewal are read again when the token comes back, and if any changed the token is refused. Changing a single character of the arguments invalidates the token too. Only a person’s approval buys it: the credential alone buys nothing, through this tool or straight to the API. On a paid plan with a card on file, for owners and admins, up to the plan’s number limit; five a minute and ten a day per workspace. The number is on the Numbers page of the Cosend dashboard too.","inputs":[{"name":"category","type":"string","required":true,"description":null},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"country","type":"string","required":true,"description":null},{"name":"display_name","type":"string","required":true,"description":null},{"name":"locality","type":"string","required":false,"description":null},{"name":"phone_number","type":"string","required":true,"description":null},{"name":"region","type":"string","required":false,"description":null},{"name":"website","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":339},{"name":"stop_cosend_number","title":"Stop using a phone number from Cosend","description":"Stops a phone number from Cosend, named by id (cnm_…), that is verifying or ready, and returns it stopping, with release_at, its last day: an hour before the billing period ends. On that day any WhatsApp connection on it is disconnected and the number is given back for good; nothing is refunded, and nothing more is billed for it. It acts only on a confirmed call: without confirmation_token it changes nothing and returns a preview of the number and a token for a person to approve; the number’s status, last day and WhatsApp connection are read again when the token comes back. Only a person’s approval stops it. Owners and admins; a workspace with an unpaid invoice may stop one too.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The Cosend number (cnm_…) to stop."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":219},{"name":"keep_cosend_number","title":"Keep a stopped phone number from Cosend","description":"Keeps a phone number from Cosend that was stopped, named by id (cnm_…), before its last day (release_at), and returns it ready: it is not given back, and from the plan’s next renewal it is billed with the plan again, at $5.95 a month, or $59.50 a year when the plan is billed yearly. Nothing is charged today. It acts only on a confirmed call: without confirmation_token it changes nothing and returns a preview of the number and a token for a person to approve; the number’s status, last day and WhatsApp connection are read again when the token comes back. Only a person’s approval keeps it. On a paid plan, for owners and admins.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The stopped Cosend number (cnm_…) to keep."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":220},{"name":"list_connectors","title":"List what can be connected","description":"Lists the integrations Cosend can connect, each by its Cosend key, with how it signs in and which of its accounts this workspace already has. The key is what a set-up link for integrations takes. Read-only.","inputs":[],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":54},{"name":"get_integration_accounts","title":"See connected integration accounts","description":"Lists the workspace’s connected integration accounts, one page at a time, or reads one when id is given. Each has its integration, name, status, the WhatsApp numbers it is used on and the reason it last failed, if it did. Credentials stay sealed in Cosend. Labels and error text come from the provider and are marked untrusted. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"connection_id","type":"string","required":false,"description":"Only the accounts used on this WhatsApp number."},{"name":"connector","type":"string","required":false,"description":"Only accounts of this integration, by its Cosend key."},{"name":"id","type":"string","required":false,"description":"One integration account to read. Left out, the accounts are listed."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."},{"name":"status","type":"string","required":false,"description":"Only accounts in this state: active, needs_reauth, error, disabled or revoked."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":212},{"name":"list_google_logins","title":"List connected Google logins","description":"Lists the Google logins connected to this workspace, each with its status and the integrations (Sheets, Calendar, Gmail) it serves. Credentials stay sealed in Cosend. Each login’s label is the address Google shows and comes back marked untrusted. Read-only.","inputs":[{"name":"connection_id","type":"string","required":false,"description":"Only the logins used on this number."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":79},{"name":"get_setup_guide","title":"Read the set-up guide","description":"Returns the workspace’s set-up guide: each step with its state, done, to do or skipped, worked out from what the workspace already has. It shows what is left to set up. Read-only.","inputs":[],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":52},{"name":"get_template","title":"Read one template","description":"Reads one message template: its components, category, language, Meta’s review status, whether it can be sent right now and, for a rejected one, Meta’s reason in Meta’s own words (marked untrusted). Read-only.","inputs":[{"name":"id","type":"string","required":true,"description":"The template: its tpl_ id, or name:language (for example order_update:en_US)."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":82},{"name":"change_template","title":"Edit, copy or delete a template","description":"Changes an existing message template at Meta. action edit replaces all of its components and returns it to review (an approved template can be edited once in 24 hours); copy creates it on another WhatsApp account of the same business, where Meta reviews it again; delete removes it at Meta and from Cosend once Meta confirms. Each change needs a confirmed call: without confirmation_token the call is a preview that returns what would happen and a token for a person to approve; called again with that token, it acts. Ten changes a day per workspace. It sends no message to anyone. Meta’s reason for a refusal is in Meta’s words.","inputs":[{"name":"action","type":"string","required":true,"description":"edit replaces the template’s components and sends it back to Meta’s review; copy makes a copy of it on another WhatsApp account of the business; delete removes it at Meta."},{"name":"authentication","type":null,"required":false,"description":"An authentication template's choices, as create takes them. An edit is one language version: languages is left out, or exactly the template's own language."},{"name":"category","type":"string","required":false,"description":"A new category, sent to Meta when it differs. Meta refuses a change on an approved template, so that is refused here first."},{"name":"components","type":"array","required":false,"description":"Meta's components, all of them; required on every category but authentication, which takes authentication instead."},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"display_name","type":"string","required":false,"description":"A new human name for the copy, from which its system name is made (with _2, _3… added when the account already has that name). Without it the copy keeps the template’s names, and an account that alre…"},{"name":"example_values","type":"object","required":false,"description":"A sample value for every variable in the TEXT header and the body, keyed per component by the name between the braces: {\"body\": {\"1\": \"Pablo\", \"2\": \"860198-230332\"}} or {\"body\": {\"first_name\": \"Pablo…"},{"name":"id","type":"string","required":true,"description":"The template: its tpl_ id, or name:language."},{"name":"language","type":"string","required":false,"description":"The template's language, which an edit keeps. Send the template's own language, or leave it out."},{"name":"name","type":"string","required":false,"description":"The template's system name, which an edit keeps. Send the template's own name, or leave it out."},{"name":"parameter_format","type":"string","required":false,"description":null},{"name":"waba_id","type":"string","required":false,"description":"The WhatsApp Business Account to copy to, as Cosend's wab_ id (a connection's waba_id, not its meta_waba_id). It must be another account of the same business portfolio."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":640},{"name":"sync_templates","title":"Refresh templates from Meta","description":"Reads the templates of one WhatsApp number from Meta now, updates what Cosend holds to match, and returns the synced list. connection_id is the number. Templates Meta changed since the last sync, such as a decision or a new category, show up here.","inputs":[{"name":"connection_id","type":"string","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":69},{"name":"list_template_category_changes","title":"See template category changes","description":"Meta sometimes moves a template to another category, which changes its price. Lists every such change Meta made or announced that nobody in the workspace has acknowledged, on the numbers the caller can see. Read-only.","inputs":[],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":51},{"name":"acknowledge_category_change","title":"Acknowledge a template category change","description":"Marks one template category change, named by id, as seen for the whole workspace, so it leaves the list of open changes. It changes nothing about the template, and nothing is sent to Meta.","inputs":[{"name":"id","type":"string","required":true,"description":"The category change to acknowledge, from the list of category changes."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":68},{"name":"get_automation","title":"Read one automation","description":"Reads one automation in one of three views. details: its name, status, number, the live version, what it clashes with while it is on and, on request, its versions and recipe settings. versions: every version, newest first, one page at a time. stats: the chats it answered alone and handed over, by day, with the top hand-over reasons. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"expand","type":"string","required":false,"description":"Comma-separated extras for view details: active_version, latest_version, ir, settings."},{"name":"id","type":"string","required":true,"description":"The automation id."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."},{"name":"range","type":"string","required":false,"description":"For view stats: today or 7d. Defaults to today."},{"name":"view","type":"string","required":true,"description":"details for the automation itself; versions for every version, newest first; stats for how it did today or over seven days."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":222},{"name":"update_automation_details","title":"Rename an automation","description":"Changes an existing automation’s name or description, and nothing else: what it does and its settings stay as they are. connection_id puts an automation made before numbers, which runs on every number, on one WhatsApp number, once; one that has a number keeps it. Returns the automation.","inputs":[{"name":"connection_id","type":null,"required":false,"description":"The WhatsApp number for an automation that has none and runs on every number. Accepted once; an automation that has a number keeps it, and another one (or null) is refused. The value it already has,…"},{"name":"description","type":null,"required":false,"description":null},{"name":"id","type":"string","required":true,"description":"The automation id."},{"name":"name","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":146},{"name":"copy_automation","title":"Copy an automation","description":"Makes a custom copy of an existing automation, a recipe’s included, on the same WhatsApp number and switched off, with its own copy of the persona, knowledge and remembered values. name is the copy’s; left out, it is the original’s followed by “(copy)”. The original is unchanged. Returns the copy.","inputs":[{"name":"id","type":"string","required":true,"description":"The automation to copy."},{"name":"name","type":"string","required":false,"description":"The copy’s name. Absent: the original’s, followed by “(copy)”."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":112},{"name":"rollback_automation","title":"Roll an automation back","description":"Points an existing automation back at an earlier version, named by its number (to_version). A version not yet ready to run is got ready first; one that cannot be is refused, and the live version stays. Its steps do not change; if the automation is switched on, it runs that version from then on. Each call needs confirming: without confirmation_token it changes nothing and returns a preview and a token for a person to approve; called again with that token, it rolls back. Returns the automation.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The automation id."},{"name":"to_version","type":"integer","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":172},{"name":"delete_automation","title":"Delete an automation","description":"Deletes an automation. One that is switched on is switched off with it, no run starts after it, it leaves the list of automations, and its id stops answering. Each call needs confirming: without confirmation_token it changes nothing and returns a preview and a token for a person to approve; called again with that token, it deletes.","inputs":[{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The automation to delete."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":131},{"name":"test_automation","title":"Test an automation on a sample customer","description":"Runs the newest version of an automation once on a sample customer as a dry run: each step is recorded as what it would have done, and every message stays inside the test. payload lays trigger fields over the sample; fail_step runs the error branch as if that step had failed. Returns the run, whose steps are read through the run tools. It uses one automation run if it starts. A version that cannot be tested is refused in words.","inputs":[{"name":"fail_step","type":"string","required":false,"description":"Optional. The id of a step: the test runs the error branch as if that step had failed, and shows what the branch would do. Refused when the automation has no error branch or no such step."},{"name":"id","type":"string","required":true,"description":"The automation id."},{"name":"payload","type":"object","required":false,"description":"Optional. Trigger subtrees (`message`, `order`, …) laid over the sample's, field by field."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":188},{"name":"run_automation","title":"Start an automation by hand","description":"Starts one run of a switched-on automation now, as its manual trigger does, with payload as the trigger’s data. It runs the live version, which acts as it was built to and can send WhatsApp messages to customers; those messages are final once sent. actions names every action the live version’s steps take, and those of a second automation set up with it, from the list in the schema (an automation’s versions list theirs as actions); a list that leaves one out or names another is refused, with the right list. The preview refuses that list as the call would, and gives no token. Each start needs confirming: without confirmation_token it changes nothing and returns a preview and a token for a person to approve; called again with that token, it starts the run. Returns the run, which the run tools follow.","inputs":[{"name":"actions","type":"array","required":true,"description":"Every action the automation’s steps take, and those of a second automation set up with it, each once: what a person approves it doing. A list that leaves one out, or names one the steps do not take,…"},{"name":"automation_id","type":"string","required":true,"description":null},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"payload","type":"object","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":310},{"name":"cancel_run","title":"Cancel a run","description":"Cancels a run that has not finished, as a stop: it needs no confirmation. Messages the run already sent stay sent. Returns the run as it is after the cancel.","inputs":[{"name":"id","type":"string","required":true,"description":"The run id."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":54},{"name":"list_automation_recipes","title":"List automation recipes","description":"Lists Cosend’s automation recipes as cards, one page at a time: each one’s slug, name, what it does, its category, the settings it asks for and the integrations it needs. Each recipe is set up with a tool of its own named after its slug. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"connection_id","type":"string","required":false,"description":"Marks the recipes that cannot work on this WhatsApp number."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":138},{"name":"get_reply_order","title":"See the order a number’s automations answer in","description":"Returns the order in which one WhatsApp number’s automations answer a customer’s message. The order follows from the automations themselves. Read-only.","inputs":[{"name":"id","type":"string","required":true,"description":"The WhatsApp number (connection) id whose automations are ordered."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":59},{"name":"list_members","title":"List workspace members","description":"Lists the people in this workspace and its pending invitations, each with role, status and email, and what the next seat costs. Names are typed by the people themselves and come back marked untrusted. Read-only.","inputs":[{"name":"connection_id","type":"string","required":false,"description":"Only the people who can see this WhatsApp number."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":69},{"name":"get_billing","title":"Read plan and invoices","description":"Reads the workspace’s billing in one of four views. subscription: plan, status, billing period and whether payment is overdue. plans: the plans it may move to, in order, with prices, allowances, seats and features. invoices: when, how much and whether paid, with Stripe’s own document. invoice: one of them. Paying and changing a card happen on a set-up link. Read-only.","inputs":[{"name":"invoiceId","type":"string","required":false,"description":"The invoice’s Stripe id, from the invoice list (view invoice)."},{"name":"view","type":"string","required":true,"description":"subscription for the current plan, status and period; plans for the plans this workspace may move to; invoices for every invoice; invoice for one, named by invoiceId."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":153},{"name":"get_report","title":"Read a Reports card","description":"Reads one card of Reports for a period: how fast chats were answered by the AI receptionist and by people (response), what the receptionist answered alone and handed over with the top reasons (receptionist), each number’s chats (numbers), each member’s chats, response times and chats marked Done (team), chats by hour of the day (hours), or each Click-to-WhatsApp ad’s chats, replied to and handed to a person (ads). Owners and admins, on the Starter plan and above. Each card covers the period asked for, from the first day Reports recorded. Hand-over reasons, member names and ad words come back marked untrusted. Read-only.","inputs":[{"name":"card","type":"string","required":true,"description":"response for how fast chats were answered; receptionist for what the AI receptionist handled; numbers for each WhatsApp number; team for each member; hours for chats by hour of the day; ads for each…"},{"name":"connection_id","type":"array","required":false,"description":"Only this WhatsApp number; repeat it for several."},{"name":"from","type":"string","required":false,"description":"A custom period’s first day (YYYY-MM-DD), with to."},{"name":"kind","type":"string","required":false,"description":"For card response: first (the default) for each chat’s first answer, every for every answer."},{"name":"period","type":"string","required":false,"description":"today, 7d (the default), 30d, or a calendar month as month:YYYY-MM, in the workspace’s time zone. Not with from and to."},{"name":"to","type":"string","required":false,"description":"A custom period’s last day (YYYY-MM-DD), with from."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":324},{"name":"get_data_policy","title":"Read how long data is kept","description":"Returns what the workspace keeps, in which group and for how long, and any queued erasure of the whole workspace. Read-only.","inputs":[],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":36},{"name":"upload_media","title":"Upload a file","description":"Uploads one file to a WhatsApp number’s media library and returns its media id (med_…), which a message, the number’s profile picture or the AI assistant’s knowledge then takes. The file travels inline as data_base64 with its mime_type, and goes to Meta and to Cosend’s storage in one call. Through an AI app a file is up to 5 MB; a larger video, audio file or document is uploaded in the Cosend dashboard. mime_type decides how WhatsApp sends it: image (jpeg, png), video (mp4, 3gpp), audio (aac, amr, mpeg, mp4, ogg), document (pdf, plain text, Word, Excel and PowerPoint) or sticker (webp). A type WhatsApp does not take, or a file over the limit, is refused before anything is stored. Every upload is its own file on that number, even with the same bytes. The file waits in the media library until a message, the profile or the assistant’s knowledge uses it.","inputs":[{"name":"connection_id","type":"string","required":true,"description":null},{"name":"data_base64","type":"string","required":true,"description":null},{"name":"filename","type":null,"required":false,"description":null},{"name":"mime_type","type":"string","required":true,"description":"One of the types WhatsApp accepts, which also decides how the file is sent: image (image/jpeg, image/png; 5 MB), video (video/mp4, video/3gpp; 16 MB), audio (audio/aac, audio/amr, audio/mpeg, audio/m…"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":378},{"name":"get_assistant_persona","title":"Read the AI assistant’s persona","description":"Reads the persona of one AI assistant, named by id (an automation of this workspace that has an AI step): business name, what the business does, tone, whether it may quote prices, the links it may send and when, the words it avoids, and the confidence threshold below which it hands a chat to a person. An assistant nobody has edited reads as the defaults, with updated_at null. Read-only.","inputs":[{"name":"id","type":"string","required":true,"description":"The id in the resource path."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":108},{"name":"update_assistant_persona","title":"Change the AI assistant’s persona","description":"Changes the persona of one AI assistant, named by id. Only the fields sent change; a list (links, never_say) is the whole new list. The persona is set through typed fields: business_name, what_you_do, tone, may_quote_prices, links, never_say and confidence_threshold. Each change needs a confirmed call: without confirmation_token the call is a preview that returns what would happen and a token for a person to approve; called again with that token, it saves. When the assistant is switched on, customers meet the new persona at their next message. Owners and admins.","inputs":[{"name":"business_name","type":"string","required":false,"description":null},{"name":"confidence_threshold","type":"number","required":false,"description":null},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"links","type":"array","required":false,"description":null},{"name":"may_quote_prices","type":"boolean","required":false,"description":null},{"name":"never_say","type":"array","required":false,"description":null},{"name":"tone","type":"string","required":false,"description":null},{"name":"what_you_do","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":246},{"name":"get_knowledge","title":"Read what the AI assistant knows","description":"Reads one AI assistant’s knowledge, named by id. view sources lists every source with its kind (file, text, website, Google place), status (queued, ready, failed), the reason a read failed, the website pages it could not load, and when it was last read; it pages with after and limit. view summary returns what the assistant learned: a short summary, the business name and one-line description read from the material, and suggested questions and answers awaiting a decision. Titles, summaries, questions and answers were read from websites and files by Cosend and come back marked untrusted. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."},{"name":"view","type":"string","required":true,"description":"sources lists the files, pasted texts, websites and Google places the assistant reads. summary reads “what I learned”: a short summary and the suggested questions and answers."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":234},{"name":"change_knowledge","title":"Change what the AI assistant knows","description":"Changes one AI assistant’s knowledge, named by id. action add takes a kind: file (media_id of a file uploaded on the assistant’s number), text (text, with an optional title), url (a website) or place (a Google Maps link); it answers at once with the source, and the assistant reads it in the background (a website is read again every month). action remove (sourceId) forgets a source and everything read from it, on a confirmed call: without confirmation_token the call is a preview that returns what would happen and a token for a person to approve. action refresh (sourceId) reads a source again now. action review_suggestion (suggestionId, accepted true or false, optional question and answer edits) turns a suggested answer into knowledge or drops it. Owners and admins.","inputs":[{"name":"accepted","type":"boolean","required":false,"description":null},{"name":"action","type":"string","required":true,"description":"add gives the assistant something to read. remove forgets one source. refresh reads one source again. review_suggestion accepts (with edits) or rejects a suggested answer."},{"name":"answer","type":"string","required":false,"description":null},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"kind","type":"string","required":false,"description":null},{"name":"media_id","type":"string","required":false,"description":"A file uploaded on this automation’s number with POST /v1/media. A file uploaded on another number is refused with media_other_number."},{"name":"question","type":"string","required":false,"description":null},{"name":"sourceId","type":"string","required":false,"description":"The sourceId in the resource path."},{"name":"suggestionId","type":"string","required":false,"description":"The suggestionId in the resource path."},{"name":"text","type":"string","required":false,"description":null},{"name":"title","type":"string","required":false,"description":null},{"name":"url","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":386},{"name":"try_assistant","title":"Try the AI assistant","description":"Asks one AI assistant (automation_id) a customer’s question and returns what it would do: its reply, the intent and confidence it read, the knowledge sources it used, whether it would hand the chat to a person, and the message a customer would receive. The trial stays inside Cosend, out of customers’ view. Each chat is one AI conversation on the plan, counted when the assistant is first asked in it; send the chat_id an answer returns, with history, to continue the same chat. For an assistant that is switched off, connection_id with holding_message (and escalate_keywords or closed hours) tries it with the set-up’s answers. Owners and admins.","inputs":[{"name":"automation_id","type":"string","required":true,"description":"The AI assistant being tried: an automation of this workspace with one AI step. The answer comes from its own persona and knowledge, and from no other assistant’s. Alone, the try also uses the escala…"},{"name":"chat_id","type":null,"required":false,"description":"The Try it chat this message continues: the chat_id an earlier answer in it gave. Each chat counts as one AI conversation, billed like a real one, from the first time the assistant is asked in it. Nu…"},{"name":"closed","type":"object","required":false,"description":"With connection_id: the set-up's closed message, opening hours (HH:MM, in the workspace's timezone) and closed-hours passing message. While closed, the answer's closed_message is the message with the…"},{"name":"connection_id","type":"string","required":false,"description":"For a receptionist that is not switched on: the number it is being set up on. Requires holding_message; escalate_keywords and closed as the set-up has them. They replace the settings of automation_id…"},{"name":"escalate_keywords","type":"array","required":false,"description":"With connection_id: the words that pass a chat to a person."},{"name":"history","type":"array","required":false,"description":null},{"name":"holding_message","type":"string","required":false,"description":"Required with connection_id, and only with it: the message a customer is sent when the assistant cannot answer."},{"name":"message","type":"string","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":507},{"name":"get_business_profile","title":"Read a number’s business profile","description":"Reads the WhatsApp business profile customers see for one number, named by id, from Meta: about, description, address, email, websites, industry and the picture’s address. read_only_reason says when the profile is edited elsewhere (a coexistence number’s is edited in the WhatsApp Business app). Read-only.","inputs":[{"name":"id","type":"string","required":true,"description":"The id in the resource path."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":86},{"name":"update_number","title":"Change a number’s settings or profile","description":"Changes one WhatsApp number, named by id. action settings takes delivery_mode (stored or direct) and override_callback_url (where Meta’s webhooks for the number go; null clears it). action display_name takes display_name and submits it to Meta’s review; Meta’s decision shows on the number later. action profile takes any of about, description, address, email, websites, vertical and profile_picture (a media id from an upload on this number); every customer sees the profile. Each action needs a confirmed call: without confirmation_token the call is a preview that names the number and returns a token for a person to approve. The number’s webhook verify token and relay secret stay sealed in the number’s settings in the Cosend dashboard, and read as null here. Owners and admins.","inputs":[{"name":"about","type":"string","required":false,"description":null},{"name":"action","type":"string","required":true,"description":"settings changes how Meta’s messages for the number are handled. display_name submits a new name to Meta’s review. profile edits the business profile customers see."},{"name":"address","type":null,"required":false,"description":null},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"delivery_mode","type":"string","required":false,"description":null},{"name":"description","type":null,"required":false,"description":null},{"name":"display_name","type":"string","required":false,"description":null},{"name":"email","type":null,"required":false,"description":null},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"override_callback_url","type":null,"required":false,"description":"Your endpoint for Meta’s webhooks for this number. On a `direct` number Cosend sets it as the number’s webhook override at Meta, and Meta sends the number’s messages, echoes, calls and history to it…"},{"name":"profile_picture","type":"object","required":false,"description":null},{"name":"retention_months","type":null,"required":false,"description":"Retention is set once for the whole account, not per connection. Set it with PATCH /v1/account/data-policy."},{"name":"vertical","type":null,"required":false,"description":null},{"name":"websites","type":"array","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":496},{"name":"manage_number","title":"Refresh or re-check a number","description":"Looks after one WhatsApp number, named by id. action sync refreshes the number’s state, quality rating and limits from Meta and returns the connection. action recheck_payment is for a person who added a payment method in Meta after a number was blocked for payment: it asks Meta again and returns the connection (adding the method itself happens in Meta’s own tools). action retry_verification takes the id of a phone number from Cosend (cnm_…) whose verification stopped, and asks WhatsApp for a new code on that same number, with no new purchase; it is allowed from the number’s preverify_retry_at, and the number shows verifying while Cosend waits up to 10 minutes for the code. Owners and admins for sync and retry_verification. Disconnecting a number is an owner’s or admin’s step in the Cosend dashboard.","inputs":[{"name":"action","type":"string","required":true,"description":"sync reads the number’s state from Meta. recheck_payment asks Meta again after a payment method was added. retry_verification asks WhatsApp again for the code that verifies a phone number from Cosend."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":241},{"name":"read_integration","title":"Look inside an integration account","description":"Reads what one connected integration account holds, named by id. view spreadsheets lists the spreadsheets a Google account can open (the ones Cosend made or a person picked for it), 100 a page at most, or with spreadsheet_id one spreadsheet and its tabs. view forms lists a form account’s forms with the id an automation’s start takes as form_id. view appointments lists a calendar account’s upcoming events from now to days ahead, with the customer number found in each and counts of events with and without one. Names, tab titles and event titles were written by people outside this workspace and come back marked untrusted. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"days","type":"string","required":false,"description":"With view appointments: how many days ahead to read, 1 to 30. Default 7."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."},{"name":"spreadsheet_id","type":"string","required":false,"description":"With view spreadsheets: read this one spreadsheet and its tabs."},{"name":"view","type":"string","required":true,"description":"spreadsheets lists a Google account’s spreadsheets, or one spreadsheet’s tabs. forms lists a form account’s forms. appointments previews a calendar’s coming events."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":280},{"name":"manage_integration","title":"Manage an integration account","description":"Manages one connected integration account, named by id; the account returns no credential. action update takes name and config (the account’s non-secret settings). action test makes one safe read at the provider and returns whether the credential works; a failed test is an answer with ok false. action add_number (connection_id) uses the account on another WhatsApp number of the workspace, the same sign-in and not a copy. action remove_number (connection_id) stops using the account on one number, provided the account stays on at least one other number and no switched-on automation there needs it, on a confirmed call: without confirmation_token the call is a preview that returns what would happen and a token for a person to approve. Signing in, and typing or replacing a key, happen on a set-up link the person opens; deleting an account or its saved login is done by a person in the Cosend dashboard. Owners and admins.","inputs":[{"name":"action","type":"string","required":true,"description":"update renames the account or changes its non-secret config. test verifies the credential. add_number and remove_number choose the WhatsApp numbers the account serves."},{"name":"config","type":"object","required":false,"description":null},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"connection_id","type":"string","required":false,"description":"The connection_id in the resource path."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"name","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":319},{"name":"create_spreadsheet","title":"Make a spreadsheet","description":"Makes a spreadsheet in a connected Google account, named by id: its title, one tab, the header columns (with a type each, text by default) and, optionally, one example row. It lands in the account’s own Google Drive and answers with its id, link, tabs and columns, which an automation’s sheet steps then use. It only creates a new spreadsheet in Google Drive.","inputs":[{"name":"columns","type":"array","required":true,"description":"The header row, first column first: 26 at most, A to Z."},{"name":"example_row","type":"array","required":false,"description":"One row under the header for the owner to type over, as wide as `columns`. Absent: the sheet has the header row only."},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"tab","type":"string","required":true,"description":"The one tab’s name."},{"name":"title","type":"string","required":true,"description":"The spreadsheet’s name, in the owner’s words."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":191},{"name":"get_approvals","title":"Read approvals","description":"Reads the human-decision queue. view list returns approvals newest first, one page at a time, optionally filtered by state; a member sees the queue of their own numbers. view one returns one approval with exactly what the human is shown (preview) and the arguments of the held action. view action_types returns every action type that can require approval with its default risk. Previews and arguments can quote customers and come back marked untrusted. A person sets the workspace’s mode per type, and decides each approval, in the Cosend dashboard. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"id","type":"string","required":false,"description":"The id in the resource path."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."},{"name":"state","type":"string","required":false,"description":"With view list: only approvals in this state."},{"name":"view","type":"string","required":true,"description":"list lists approvals. one reads one approval by id. action_types lists what can need approval."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":225},{"name":"request_approval","title":"Hold an action for a person’s decision","description":"Holds an action for a human decision: action (a type from the approval action types), preview (exactly what the person is shown, up to 4096 characters), arguments, and optionally risk (it can only raise the type’s default) and run_id. The approval is pending, expires 24 hours after it is made (an expiry is a rejection), and appears in the Cosend approvals queue for a person to approve or reject. The workspace’s setting for that action type can also approve or reject it at once, and the answer says which. It only files the request for a person to decide. A retry with the same arguments returns the same approval.","inputs":[{"name":"action","type":"string","required":true,"description":null},{"name":"arguments","type":"object","required":false,"description":null},{"name":"preview","type":"string","required":true,"description":null},{"name":"risk","type":"string","required":false,"description":null},{"name":"run_id","type":null,"required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":178},{"name":"list_audiences","title":"List saved audiences for campaigns","description":"Lists the saved audiences of this workspace, one page at a time: each one’s id, name, the WhatsApp number it was saved for, and who it names (contact tags and that number’s chat labels, any or all). A campaign’s audience is one of these. They are saved on the Campaigns page of the Cosend dashboard, or by an AI app, by an owner or an admin; this tool only reads them. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":152},{"name":"create_audience","title":"Save an audience for campaigns","description":"Saves an audience for campaigns, with a name, the WhatsApp number it is for and who it names (contact tags and that number’s chat labels, any or all), and returns it with its id, the audience.segment_id a campaign takes. It sends nothing and messages nobody. The audience is on the Campaigns page of the Cosend dashboard too. Campaigns are on the Starter plan and above, and for owners and admins.","inputs":[{"name":"connection_id","type":"string","required":true,"description":null},{"name":"definition","type":"object","required":true,"description":null},{"name":"name","type":"string","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":119},{"name":"list_campaigns","title":"List campaigns","description":"Lists this workspace’s campaigns, newest first, one page at a time: each one’s id, state (draft, scheduled, sending, paused, sent or stopped), number, template, saved audience, time, quiet hours, and how many it was for, sent, delivered, read, got a reply from and failed for. These are the campaigns on the Campaigns page of the Cosend dashboard. Read-only.","inputs":[{"name":"after","type":"string","required":false,"description":"The next_cursor of the previous page, to read the page after it. Omit for the first page."},{"name":"connection_id","type":"array","required":false,"description":"Only campaigns on this WhatsApp number. Repeat for several."},{"name":"limit","type":"integer","required":false,"description":"How many records to return. Defaults to 25, maximum 100."},{"name":"q","type":"string","required":false,"description":"Only campaigns whose name contains this."},{"name":"status","type":"array","required":false,"description":"Only campaigns in this state, e.g. draft or sending. Repeat for several."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":198},{"name":"get_campaign","title":"Get a campaign and its results","description":"Returns one campaign, named by id, and its results together. The campaign: its state, number, template and the value of each blank, saved audience, time, quiet hours, and why it paused, stopped or could not start. The results: how many it was for, sent, delivered, read, replied, failed, were left out and are still to go, failures by group, sends per 10 minutes and what is left by day. A reply counts for 72 hours after the campaign ends. Read-only.","inputs":[{"name":"id","type":"string","required":true,"description":"The id in the resource path."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":128},{"name":"create_campaign","title":"Start a campaign draft","description":"Starts a campaign as a draft, with a name and the WhatsApp number it goes out on, and returns it with its id. It sends nothing and messages nobody: a draft waits until a person approves it. The draft is on the Campaigns page of the Cosend dashboard too. Campaigns are on the Starter plan and above, and for owners and admins.","inputs":[{"name":"connection_id","type":null,"required":false,"description":null},{"name":"name","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":95},{"name":"update_campaign","title":"Change a campaign draft","description":"Saves one or more steps of a campaign draft, named by id, and returns it. A step is its name; its number; its template (template_id, a marketing template on that number’s WhatsApp account); the value of each blank (variable_map: a contact field’s key, first_name or name, with fallback text for people who have none, or one text for everyone); what the template shows on top (header: a picture, video or document uploaded to Cosend by its media_id, and the template’s own file when none is chosen; a place by its latitude, longitude, name and address; or the title’s blanks, as variable_map); the value of a link button’s blank and a coupon code (buttons, by the button’s index); its audience, which is a saved audience by its id (audience.segment_id) and nothing else; a time to send it, in a time zone; and its quiet hours, when nothing is sent. Changing the number clears the template and the blanks. A scheduled campaign that is changed is a draft again, and any estimate it had is cleared. It sends nothing.","inputs":[{"name":"ab","type":null,"required":false,"description":null},{"name":"audience","type":"object","required":false,"description":null},{"name":"buttons","type":"array","required":false,"description":null},{"name":"cards","type":"array","required":false,"description":null},{"name":"connection_id","type":"string","required":false,"description":null},{"name":"header","type":null,"required":false,"description":null},{"name":"id","type":"string","required":true,"description":"The id in the resource path."},{"name":"kind","type":"string","required":false,"description":null},{"name":"let_join","type":"boolean","required":false,"description":null},{"name":"name","type":"string","required":false,"description":null},{"name":"quiet_hours","type":"object","required":false,"description":null},{"name":"reply_rules","type":"array","required":false,"description":null},{"name":"schedule","type":null,"required":false,"description":null},{"name":"steps","type":"array","required":false,"description":null},{"name":"template_id","type":null,"required":false,"description":null},{"name":"track_clicks","type":"boolean","required":false,"description":null},{"name":"variable_map","type":"array","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":365},{"name":"preview_campaign","title":"Check a campaign before it sends","description":"Checks a campaign draft, named by id, and returns what sending it would do, under two keys. audience: how many the saved audience matches, how many get it, how many are left out and why (no WhatsApp number, blocked, opted out on this number, a US number, WhatsApp held back a marketing message to them in the last day, a blank with no value, or a chat open with them now), the first 20 people, and Meta’s list price for one delivered marketing message to each person who gets it, by market, in the WhatsApp account’s currency. estimate: the estimate_id a send names, which lasts 15 minutes; the count; the daily limit and what goes out on which day; the plan’s messages left; and whether the count must be confirmed, which it must above 500. It saves the estimate on the draft and sends nothing. The template must be approved by WhatsApp. Names in the sample were written by the customers themselves and come back marked untrusted.","inputs":[{"name":"id","type":"string","required":true,"description":"The id in the resource path."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":230},{"name":"send_campaign","title":"Send or schedule a campaign","description":"Sends a campaign draft now, or schedules it for its time, named by id, with the estimate_id of a check made in the last 15 minutes; above 500 people, confirm_text is that count. It reaches every person the check counted, on their phones, and the messages cannot be unsent. It sends only on a confirmed call: without confirmation_token it sends nothing and returns a preview and a token for a person to approve. The preview shows the campaign (its number, template and the value of each blank, the file or the place on top, its buttons’ values, saved audience, time and quiet hours) and who gets it now, who is left out and Meta’s list price, all read again when the token comes back: if any of it changed after the preview, the token is refused and a new preview is needed. Changing a single character of the arguments invalidates the token too. Only a person’s approval sends it: the credential alone sends nothing, through this tool or straight to the API. Five a minute and ten a day per workspace. Each campaign is on the Campaigns page of the Cosend dashboard.","inputs":[{"name":"confirm_text","type":"string","required":false,"description":null},{"name":"confirmation_token","type":"string","required":false,"description":"For a call that needs approval: left out, the call does nothing and returns a preview and a token; given that token, with the same arguments, the call does it."},{"name":"estimate_id","type":"string","required":true,"description":null},{"name":"id","type":"string","required":true,"description":"The campaign to send."},{"name":"when","type":"string","required":true,"description":"now sends the draft now; scheduled schedules it for the time the draft has, in its time zone."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":338},{"name":"cancel_campaign","title":"Stop a campaign","description":"Stops a campaign, named by id, that is scheduled, sending or paused, and returns it stopped: nothing more goes out, and sends still waiting are cancelled. Messages already sent stay sent. A stopped campaign does not start again; its results stay readable. Stopping a draft, or a campaign that has finished, is refused in words.","inputs":[{"name":"id","type":"string","required":true,"description":"The id in the resource path."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":90}],"toolsTruncatedAtCapture":false,"diagnostics":{"capturedAt":"2026-11-21T03:13:17.000Z","track":"remote","endpoint":"https://mcp.cosend.app/mcp","declaredUrl":null,"truncated":false,"tls":{"outcome":"valid","label":"Valid","version":"TLS 1.3","cipherSuite":"TLS_AES_128_GCM_SHA256","chainError":null,"certificates":[{"subject":"CN=mcp.cosend.app","issuer":"CN=WE1,O=Google Trust Services,C=US","notBefore":"2026-10-29T20:46:07Z","notAfter":"2027-01-27T21:46:04Z","keyType":"ECDSA","keyBits":256,"isCa":false},{"subject":"CN=WE1,O=Google Trust Services,C=US","issuer":"CN=GTS Root R4,O=Google Trust Services LLC,C=US","notBefore":"2023-12-13T09:00:00Z","notAfter":"2029-02-20T14:00:00Z","keyType":"ECDSA","keyBits":256,"isCa":true},{"subject":"CN=GTS Root R4,O=Google Trust Services LLC,C=US","issuer":"CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE","notBefore":"2023-11-15T03:43:21Z","notAfter":"2028-01-28T00:00:42Z","keyType":"ECDSA","keyBits":384,"isCa":true}]},"dnssec":{"result":"insecure","label":"Not signed","name":"mcp.cosend.app.","steps":[{"zone":".","outcome":"verified","label":"Verified"},{"zone":"app.","outcome":"verified","label":"Verified"},{"zone":"cosend.app.","outcome":"insecure_proven","label":"Unsigned (proven)"}]},"auth":{"outcome":"enforced_validated","label":"Enforced and verified","gate":"invoke","gateLabel":"On tool calls","status":200,"authorizationServers":["https://auth.cosend.app"]},"httpsRedirect":{"outcome":"https_enforced","label":"HTTPS enforced","status":301},"transports":[{"transport":"streamable-http","outcome":"verified","label":"Verified","status":200,"followed":false}],"provenance":null,"installScripts":[],"installScriptsTotal":null,"vulnerabilities":[],"vulnerabilitiesTotal":null,"dependencies":null},"mismatches":[],"changelog":{"trackingSince":"2026-11-01","recent":[{"id":"chg_01a1fc18-112a-7cdd-9c59-00e8bb0e4892","kind":"score.total_changed","summary":"Trust score (83 → 84)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-21","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1fc18-112a-7cdd-9c59-00e8bb0e4892"},{"id":"chg_01a1f6f2-a492-7ddb-91c5-89a07fbf834f","kind":"tool.description_changed","summary":"Tool “rollback_automation” rewrote its description, which is the text the model reads","materiality":"security","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-20","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1f6f2-a492-7ddb-91c5-89a07fbf834f"},{"id":"chg_01a1f6f2-a494-7cb7-b4c4-6cd32a9d5494","kind":"tool.description_changed","summary":"Tool “switch_on_automation” rewrote its description, which is the text the model reads","materiality":"security","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-20","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1f6f2-a494-7cb7-b4c4-6cd32a9d5494"},{"id":"chg_01a1f1cc-61c3-7900-a017-1347bf645ce6","kind":"score.total_changed","summary":"Trust score (82 → 83)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-19","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1f1cc-61c3-7900-a017-1347bf645ce6"},{"id":"chg_01a1eca6-a3a9-79c0-b8b5-e35ad20fa7fa","kind":"tool.description_changed","summary":"Tool “get_inbox_overview” rewrote its description, which is the text the model reads","materiality":"security","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-18","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1eca6-a3a9-79c0-b8b5-e35ad20fa7fa"},{"id":"chg_01a1eca6-a3ae-7cab-958f-ec87fbc41eb9","kind":"param.description_changed","summary":"“update_contact” reworded the description of “attributes”","materiality":"cosmetic","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-18","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1eca6-a3ae-7cab-958f-ec87fbc41eb9"},{"id":"chg_01a1eca6-a3b2-7961-ad93-e8fb313a885c","kind":"param.description_changed","summary":"“upsert_contact” reworded the description of “attributes”","materiality":"cosmetic","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-18","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1eca6-a3b2-7961-ad93-e8fb313a885c"},{"id":"chg_01a1e781-7c76-7cbb-aff4-9c7493a73afe","kind":"check.verdict","summary":"Stability (0.43 → fail)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1e781-7c76-7cbb-aff4-9c7493a73afe"},{"id":"chg_01a1e781-7c7a-7176-93ef-ddd109e44ef7","kind":"check.measure","summary":"Schema quality (215 → 241)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1e781-7c7a-7176-93ef-ddd109e44ef7"},{"id":"chg_01a1e781-7c7b-79af-85a9-544e064b74cf","kind":"check.appeared","summary":"First check of Tool coverage (1)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1e781-7c7b-79af-85a9-544e064b74cf"},{"id":"chg_01a1e781-7c7c-7475-a01c-d34d50eb5186","kind":"tool.removed","summary":"Tool “automation_recipes” was removed","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1e781-7c7c-7475-a01c-d34d50eb5186"},{"id":"chg_01a1e781-7c7c-7db0-b750-ece9344174b9","kind":"tool.description_changed","summary":"Tool “deploy_automation” rewrote its description, which is the text the model reads","materiality":"security","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1e781-7c7c-7db0-b750-ece9344174b9"},{"id":"chg_01a1e781-7c7d-74d2-ba30-4cb692024fd4","kind":"param.new_required","summary":"“deploy_automation” added a required parameter “actions”, so existing callers break","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1e781-7c7d-74d2-ba30-4cb692024fd4"},{"id":"chg_01a1e781-7c7d-7e12-a4e0-565a325b5f34","kind":"tool.removed","summary":"Tool “describe_automation” was removed","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1e781-7c7d-7e12-a4e0-565a325b5f34"},{"id":"chg_01a1e781-7c7e-7756-9aa4-3103b9a86e79","kind":"tool.removed","summary":"Tool “draft_reply” was removed","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1e781-7c7e-7756-9aa4-3103b9a86e79"},{"id":"chg_01a1e781-7c7f-7675-898c-76bd98dcfef2","kind":"tool.removed","summary":"Tool “get_authoring_chat” was removed","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1e781-7c7f-7675-898c-76bd98dcfef2"},{"id":"chg_01a1e781-7c7f-7bd1-81f0-c155b8932b33","kind":"tool.removed","summary":"Tool “get_automation_catalogue” was removed","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1e781-7c7f-7bd1-81f0-c155b8932b33"},{"id":"chg_01a1e781-7c80-7535-9bd6-9f8412e21d24","kind":"tool.description_changed","summary":"Tool “get_report” rewrote its description, which is the text the model reads","materiality":"security","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1e781-7c80-7535-9bd6-9f8412e21d24"},{"id":"chg_01a1e781-7c80-7b2f-85fb-dc68daa971fd","kind":"param.description_changed","summary":"“get_report” reworded the description of “card”","materiality":"cosmetic","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1e781-7c80-7b2f-85fb-dc68daa971fd"},{"id":"chg_01a1e781-7c81-74e2-8137-6dfea92a653e","kind":"tool.description_changed","summary":"Tool “import_contacts” rewrote its description, which is the text the model reads","materiality":"security","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/app-cosend-mcp/mcp#chg-chg_01a1e781-7c81-74e2-8137-6dfea92a653e"}],"truncated":true,"feedUrl":"https://verifymcp.io/servers/app-cosend-mcp/mcp/changelog.json"},"links":{"html":"https://verifymcp.io/servers/app-cosend-mcp/mcp","markdown":"https://verifymcp.io/servers/app-cosend-mcp/mcp.md","changelogJson":"https://verifymcp.io/servers/app-cosend-mcp/mcp/changelog.json","changelogRss":"https://verifymcp.io/servers/app-cosend-mcp/mcp.xml","external":[{"label":"Remote endpoint","href":"https://mcp.cosend.app/mcp"},{"label":"Repository","href":"https://github.com/cosendhq/cosend-plugin"},{"label":"Website","href":"https://cosend.app/mcp"}]}}