List engagement signals
The people who engaged with posts your watches are following.
To poll: call with no cursor, process the events, save next_cursor, and pass it back next time to get whatever has arrived since. next_cursor comes back on every non-empty page, including the last one; has_more: false means you are caught up, not that the feed has ended.
Delivery is at-least-once. Each event carries a stable id; store the ids you have processed and skip repeats rather than assuming an event arrives exactly once.
Filter with persona_id to see only the engagers who matched a persona. Unfiltered, you get everyone the watch found, which is also how you tell “nobody relevant engaged” from “the personas are too narrow”.
Distinct from List ICP signals, which reports things that happened to a company. Every event here is a person who did something.
Authorizations
Account API key passed in the Authorization header
Query Parameters
Target account UUID. Required for staff callers; ignored for customer API keys (they always read their own account).
Only return engagers surfaced by this watch. Omit for every watch on the account.
Repeatable. Only return engagers who matched at least one of these personas. Omit to include everyone the watch found, matched or not.
Only return events detected at or after this RFC3339 timestamp. Prefer the cursor for sequential polling: since re-reads a window, the cursor advances through it.
"2026-08-01T00:00:00Z"
Pagination cursor from a previous call. Save next_cursor and pass it back unchanged to fetch what has arrived since. Cursors stay valid indefinitely unless this endpoint returns a 400.
Maximum events to return.
1 <= x <= 500Response
OK
Events in detection order, oldest first, so a consumer can walk forward without new arrivals reshuffling the page.
True when more events are already waiting. False means you are caught up, not that the feed is finished.
Pass back unchanged to fetch events detected after this page. Returned on every non-empty page, including the last: a feed has no end, only a current position.