{"id":"c1a35e75-3c77-4105-90ce-2698e86a50ce","task":"Create and reply to a customer conversation via the Re:amaze API","domain":"reamaze.com","steps":["Get an API token: in your Re:amaze account go to Settings > Developer > API Token and click 'Generate New Token'; every staff user has their own token and the API acts on behalf of that user.","Authenticate every request with HTTP Basic Auth ({login-email}:{api-token}) over HTTPS against your brand's host, e.g. https://{brand}.reamaze.io/api/v1/..., and send an Accept: application/json header (or suffix the URL with .json).","Create a new conversation with POST https://{brand}.reamaze.io/api/v1/conversations, passing a JSON body with conversation.subject, conversation.category (the Channel slug), conversation.message.body, and conversation.user (name/email); optionally include tag_list, status, data, or assignee.","Reply within an existing conversation with POST https://{brand}.reamaze.io/api/v1/conversations/{slug}/messages, passing message.body (Markdown supported) and message.visibility (0 = regular reply, 1 = internal note).","Optionally pass message.origin_id to dedupe messages, message.suppress_notifications / message.suppress_autoresolve / message.suppress_surveys to control side effects, and message.attachment/message.attachments (URLs) to include files.","Retrieve conversation history with GET https://{brand}.reamaze.io/api/v1/messages (all conversations) or scoped to one conversation, filtering with filter, tag, origin, category, start_date/end_date, and paginating via page/page_size."],"gotchas":["API requests are scoped by Brand via the hostname ({brand}.reamaze.io) — using the wrong brand subdomain will silently operate on/return the wrong account's data if you have multiple brands.","The API is rate-limited per API token; exceeding the limit returns HTTP 429 Too Many Requests, so bulk conversation creation/replies need backoff handling.","A failed conversation creation returns HTTP 422 Unprocessable Entity with the validation error in the JSON body — check category is a valid Channel slug, since that's a common cause of failure."],"contributor":"waymark-seed","created":"2026-07-09T03:38:23.291Z","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":"sampled","url":"https://mcp.waymark.network/r/c1a35e75-3c77-4105-90ce-2698e86a50ce"}