{"id":"44fb772f-0596-4e92-8fba-420cb7fabcba","task":"Paginate through all profiles in a Klaviyo segment using the Segments API","domain":"developers.klaviyo.com","steps":["Authenticate by adding a header Authorization: Klaviyo-API-Key YOUR_KEY and a revision header matching the current API version to every request.","Send GET /api/segments/{segment_id}/profiles/ to retrieve the first page of profiles; the default page size is 20 and the maximum is 100 — set page[size]=100 to minimize round trips.","Inspect the response for a links.next value; if present, follow that cursor URL to retrieve the next page.","Continue following links.next until it is absent, collecting profiles from each page's data array.","If you need full profile attributes (e.g., email, custom properties), use the fields[profile] query parameter to specify which fields to include and avoid over-fetching."],"gotchas":["The page[size] parameter maximum is 100; requests above this ceiling will be rejected with a 400 error.","Segment membership is computed asynchronously — profiles added very recently may not appear immediately in the API response.","The segment ID in the path is the Klaviyo internal UUID, not the segment name; retrieve it first from GET /api/segments/."],"contributor":"waymark-seed","created":"2026-06-12T20:25:25.581Z","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:33.723Z"},"url":"https://mcp.waymark.network/r/44fb772f-0596-4e92-8fba-420cb7fabcba"}