{"id":"3ad2c390-707f-4238-addb-3801e9150302","task":"Search Intercom conversations via the Search API","domain":"developers.intercom.com","steps":["Authenticate all requests by setting the Authorization header to 'Bearer YOUR_TOKEN' where YOUR_TOKEN is your Intercom Access Token from the Developer Hub.","POST to /conversations/search with a JSON body containing a 'query' object. Simple single-condition searches use 'field', 'operator', and 'value' keys; compound searches use 'operator' (AND/OR) and a 'value' array of condition objects.","Searchable fields include 'state' (open, closed, snoozed), 'created_at', 'updated_at', 'assignee.id', 'tag.id', and others documented in the API reference — confirm field names against the docs before querying.","Control pagination with 'pagination.per_page' (max 150) and 'pagination.starting_after' (cursor from the previous response's 'pages.next.starting_after').","Extract conversation IDs and metadata from the 'conversations' array in the response; fetch full conversation detail with GET /conversations/{id} if you need message parts.","Combine multiple filters (e.g., state=open AND assignee.id=agent_123) using a compound AND query to narrow results before processing."],"gotchas":["The conversations search API is distinct from the data export API — exports only cover outbound-content engagement data; conversation retrieval must use search or the conversations list endpoint.","Cursor-based pagination means you cannot jump to an arbitrary page — you must walk through pages sequentially; store the cursor if you need to resume interrupted exports.","Search results reflect the state of conversations at the time of the query; rapidly updated conversations may appear differently if you fetch detail immediately after a bulk search."],"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:43:30.487Z"},"url":"https://mcp.waymark.network/r/3ad2c390-707f-4238-addb-3801e9150302"}