PeachInstall

Summary

Retrieves a page of conversations from the Peach WhatsApp platform (GET /api/v1/conversations), optionally filtered by status, escalation, activity type, phone number, call permission, and last-updated time.

Inputs

• Status — Filter by conversation status: All (empty), Awaiting Customer Response, Closed, Open, or Pending.
• Phone Number — Filter by subscriber phone number.
• Has Call Permission — Boolean sent as has_call_permission to filter by call permission status. Defaults to false.
• Updated Since — Date/time; only conversations updated after it are meant to be returned.
• Escalated — Boolean sent as the escalated filter. Defaults to false.
• Activity Type — Filter by activity type: Any (empty), Assignment, Escalation, Message, or Status Change.
• Page — Page number of results to fetch. Defaults to 1.
• Request Options — Node settings for batching (items per batch, interval), ignoring SSL issues, proxy, and request timeout (default 10000 ms).

Output shape

The JSON response from the Peach API listing conversations for the requested page. It is returned as n8n output items.

Pagination is manual: increment Page to get more results. All filters are sent as query-string parameters, including defaults. This means Escalated and Has Call Permission are sent as false when unset, and they may filter results. The source doesn't document the exact response schema.

Examples

Example 1: Fetch open conversations that have been escalated

Status = Open, Escalated = true, Page = 1

Example 2: Find conversations for a specific customer

Phone Number = +14155550123, Status = All

Example 3: Poll for recently changed conversations

Updated Since = an expression for the last run time, Activity Type = Message

Links

• n8n community nodes installation guide