[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup) # Update Help Scout Docs articles after a product change > After a release, find the Help Scout Docs articles that mention the change, save corrected drafts, review them and publish on your OK. Runs weekly. Source: https://cotlet.dev/integrations/help-scout-api-mcp-server/update-docs-articles Your product changed a menu name on Tuesday, and three Docs articles still tell customers to click the old one, because nobody searched Docs for it. Cotlet does it in your own Help Scout account with search\_docs\_articles, get\_docs\_article, save\_docs\_article\_draft and publish\_docs\_article, called by your AI agent, an n8n workflow or a script. [Sign up free](https://cotlet.dev/app/signup?app=help-scout) [All Help Scout tools](https://cotlet.dev/integrations/help-scout-api-mcp-server.md) Hosted · nothing to install or maintain ## Can Help Scout do this on its own? Help Scout's Docs API has Save Article Draft and Update Article, and the official MCP can read Docs articles with a Docs API key, but the MCP is read-only for new connections, so an agent cannot edit Docs through it (checked 16 Oct 2026). Using the Docs API yourself needs an API key for the Docs site. Nothing in Help Scout finds the articles an announcement affects. ## How you do it in Help Scout today 1. Search for the old menu name: each search returns conversations, customers and Docs articles, and a click on the Docs header lists the articles that mention it. 2. Open Tools > Docs, choose the collection and open the article in the Docs editor. The editor saves your changes as a draft automatically and shows a green check mark with the word Saved. 3. Edit the text, use Preview to see it as it will look on your Docs site, and click Update on a published article to put it live. A new article uses Publish. 4. The drop-down next to Update holds Unpublish, which removes the article from the site without deleting it, and Discard changes, which has no restore. 5. Every article that mentions the change needs its own edit, so the slow part is finding them all. ## How to update Help Scout Docs articles after a product change Prompt ``` Read this week's release notes below. Find every Help Scout Docs article that mentions the changed screens, save the corrected text as a draft of each, and show me the differences. Publish nothing until I say so. ``` 1. 01 ### Find every affected article search\_docs\_articles searches for each old term from the changelog, such as a renamed menu or a removed button, and merges the hits into one list with the collection each article sits in. 2. 02 ### Read the current text get\_docs\_article returns the article as published, and the draft too if one is open. If a draft with someone else's edits exists, the agent flags it instead of overwriting it. 3. 03 ### Write corrected drafts save\_docs\_article\_draft changes only the sentences that mention the change and leaves the structure and images alone. A draft does not touch the published article, so it is safe to run unattended. 4. 04 ### Show the differences The agent reports each article with the old and new sentence side by side, so you review wording in one message instead of opening every article. 5. 05 ### Publish only on your word publish\_docs\_article puts a draft live on your public Docs site and asks for your OK per article by default. The agent publishes the ones you approve and leaves the rest as drafts. ### What you get back Example data ``` Release notes: "Reports" is now called "Insights" Articles mentioning "Reports": 4 Draft saved for 3: - "Export conversation data": 2 sentences changed - "Read your email report": 1 sentence changed - "Set up a daily digest": 1 sentence changed Left alone 1: "Reports API overview" has an open draft by Maria Published: 0 (waiting for your OK) ``` ### Other ways to ask - Every Monday, check the last 7 days of release notes and save drafts only, with a list of what changed. - Find Docs articles that have not been edited for a year and list them with the screens they describe. - Unpublish the article "Old pricing FAQ" and tell me which other articles link to it. ## What Help Scout allows, and what to know first - Help Scout Docs has two article statuses, published and notpublished, and a draft is a separate version shown by a hasDraft flag, so a saved draft never changes the live article. - Publishing an article that has a draft deletes the draft, and Discard changes in the editor has no restore. - By default every Help Scout user can edit, publish and delete Docs articles; Account Owners and Administrators can restrict that in the permission settings. - An article name must be unique within its collection. - The Free plan includes one Docs site with 10 articles; paid plans include 2, 3 or 5 Docs sites, and extra sites cost $20 a month on annual billing or $24 monthly. publish\_docs\_article asks for your OK by default. To run it weekly without you, switch confirmation off for that tool in your dashboard. Sources: [Help Scout Docs: Create and manage Docs articles](https://docs.helpscout.com/article/182-create-and-manage-docs-articles) · [Help Scout Docs: About the Docs editor](https://docs.helpscout.com/article/1499-about-the-docs-editor) · [Help Scout Docs API: Update Article](https://developer.helpscout.com/docs-api/articles/update/) · [Help Scout Docs API: Save Article Draft](https://developer.helpscout.com/docs-api/articles/save-draft/) · [Help Scout pricing](https://www.helpscout.com/pricing/) ## Call save\_docs\_article\_draft from a script curl ``` curl -X POST https://cotlet.dev/api/v1/help-scout/articles/6628f1a2b5d30/docs-article-draft/save \ -H "Authorization: Bearer $COTLET_API_KEY" \ -H "Content-Type: application/json" \ -d '{"text":"

Open Insights from the top menu, choose a date range and click Export.

"}' ``` Example response ``` { "article_id": "6628f1a2b5d30", "has_draft": true, "status": "published" } ``` MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is help\_scout\_write → save\_docs\_article\_draft. Example data. [Schedule it in n8n, Make, Zapier or cron](https://cotlet.dev/integrations/help-scout-api-mcp-server.md#automations) ## Help Scout tools this automation uses __Cotlet Help Scout tools used to update Help Scout Docs articles after a product change__ | Tool | Parameters | | -------------------------- | -------------------- | | search\_docs\_articles | query, status, limit | | get\_docs\_article | article\_id, draft | | save\_docs\_article\_draft | article\_id, text | | publish\_docs\_article | article\_id, action | [All 14 Help Scout tools with descriptions](https://cotlet.dev/integrations/help-scout-api-mcp-server.md#tools) ## Frequently asked questions ### Is it safe to connect Help Scout to Cotlet? Yes. You sign in to Help Scout yourself, in your own Cloud Browser in the EU, and we never save your password. Your agents only get Help Scout once you enable it, every background request is listed, and the browser profile is stored encrypted with AES-256-GCM, the cipher 1Password uses for its vaults. The AI model never sees a login, posts and messages wait for your OK, and Disable for agents cuts access in one click. Independent scanners grade cotlet.dev A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory; live results are on https://cotlet.dev/security. ## More Help Scout automations - [Reply to Help Scout conversations from your Docs articles](https://cotlet.dev/integrations/help-scout-api-mcp-server/reply-from-help-docs.md) - [Tag and assign new Help Scout conversations with AI](https://cotlet.dev/integrations/help-scout-api-mcp-server/tag-and-assign-conversations.md) - [Help Scout API and MCP server: every tool](https://cotlet.dev/integrations/help-scout-api-mcp-server.md) - [All use cases](https://cotlet.dev/use-cases.md) ## Give your agent access to Help Scout. Free 7-day trial with 2,000 credits, no card needed. Cotlet is independent and not affiliated with Help Scout. [Sign up free](https://cotlet.dev/app/signup?app=help-scout) --- Give your AI agents your signed-in browser. **Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md) **Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet) **Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) **Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md) **Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors) **Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet) Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners. ## For AI agents: sign your user up Is your user asking you to sign them up for Cotlet? You can do it for them, no account or key needed. 1. Read the fields and their allowed values: GET https://cotlet.dev/api/v1/access-requests 2. Ask the user for each value: email, apps, what you will do with them. If they leave the password to you, generate a strong one and show it to them. 3. Show the user what you will send, then POST it as JSON to https://cotlet.dev/api/v1/access-requests. One call creates the account and sends the access request; we email the user when access is granted.