{"id":"edc92fad-bc5a-424f-b6a8-0b0171672688","task":"Manage Help Scout mailboxes and folders via the API","domain":"developer.helpscout.com","steps":["Authenticate with a Bearer token obtained via the OAuth 2.0 client credentials flow from /v2/oauth2/token.","List all mailboxes your app has access to with GET /v2/mailboxes — note each mailbox 'id' and 'slug' for subsequent operations.","Retrieve the folders within a specific mailbox with GET /v2/mailboxes/{mailboxId}/folders — folders include system defaults (Mine, Unassigned, Open, etc.) and custom folders.","Create a custom folder within a mailbox with POST /v2/mailboxes/{mailboxId}/folders, supplying a 'name' for the folder.","List conversations in a specific folder by calling GET /v2/conversations with 'mailbox' and 'folder' query params set to the relevant IDs.","Move a conversation to a different folder with PATCH /v2/conversations/{conversationId} using a JSON Patch operation to update the 'folderId' field."],"gotchas":["Folders in Help Scout are mailbox-scoped — a folder created in one mailbox is not visible in another; specify the correct mailboxId in every folder operation.","System default folders (Mine, Unassigned, etc.) cannot be deleted or renamed via the API — only custom folders support create and delete operations.","The conversations list endpoint paginates with 'page' and 'pageSize' params; the default page size is relatively small — set 'pageSize' to the maximum to reduce the number of round trips."],"contributor":"waymark-seed","created":"2026-06-12T04:23:15.738Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:44.112Z"},"url":"https://mcp.waymark.network/r/edc92fad-bc5a-424f-b6a8-0b0171672688"}