Kapso APIInstall

Summary

Lists Kapso conversations, optionally filtered by status, phone number, assigned user, and created or last-active date ranges. Supports returning all results or a single page, using cursor pagination.

Inputs

• Return All — If true, fetches every page of results. Default false.
• Per Page — Results per request when Return All is off (1–100, default 20). Sent to Kapso as limit.
• Status — Filter by conversation status: Any (default), Active or Ended.
• Filter Phone Number — Partial match on the contact's phone number (max 128 characters).
• Filter Phone Number ID — Kapso phone number UUID to restrict conversations to one business number.
• Assigned User ID — Kapso user UUID; returns only conversations assigned to that user.
• Unassigned Only — If true, returns only conversations with no assigned user.
• Created After / Created Before — ISO 8601 bounds (inclusive) on conversation creation time.
• Last Active After / Last Active Before — ISO 8601 bounds (inclusive) on last activity time.
• After Cursor / Before Cursor — Cursors from the previous response's paging.cursors.after or paging.cursors.before, for manual paging (max 128 characters).

Output shape

A list of conversation records returned as n8n items.

With Return All off, one page is returned, limited by Per Page. Use the paging cursors from the response to fetch the next or previous page. The exact item shape is defined by the Kapso API. The source pack shows only signatures, so exact handling of the response envelope is not confirmed.

Examples

Example 1: Find unanswered active chats nobody owns

Status = Active, Unassigned Only = true, Return All = true.

Example 2: Review one customer's conversations from the last week

Filter Phone Number = the customer's number, Created After = a date 7 days ago, Per Page = 50.

Links

• n8n community nodes installation guide