List the profiles in a segment
Who meets its conditions now, most recently seen first, a page at a time by cursor (`nextCursor` until the last page). Read live: a big segment takes its time. 409 `segment_not_published` for the published version of a segment never published.
Who meets its conditions now, most recently seen first, a page at a time by cursor (nextCursor until the last page). Read live: a big segment takes its time. 409 segment_not_published for the published version of a segment never published.
apiKey readAuthorizationBearer <token>A workspace API key (pf_…), created under Developers → API keys.
Scope: read
id*string^(seg)_[0-9A-Za-z]{8}$cursor?stringThe previous page’s nextCursor; omit for the first page
length <= 200pageSize?numberOne of 10, 25, 50, 100
25version?stringpublished (the default: the one in use) or draft
"published""published""draft"OK
application/json- response
items*array<>pageSize*integernextCursor*string|nullcurl -X GET 'https://api.postforge.dev/v1/segments/string/profiles'{ "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "email": "string", "phone": "string", "locale": "string", "storeIds": [ "636b56cb-e414-46d5-b6c0-0e73b3e0106b" ], "ordersCount": 0, "lastOrderAt": "2019-08-24T14:15:22Z", "emailMarketingConsent": "subscribed", "smsMarketingConsent": "subscribed", "firstSeenAt": "2019-08-24T14:15:22Z", "lastSeenAt": "2019-08-24T14:15:22Z" } ], "pageSize": 0, "nextCursor": "string"}Remove profiles from a list POST
Every address of each profile comes off the list; each one removed gets *List Left* on their timeline. Up to 1,000 profiles per call.
Explain whether a profile is in a segment POST
Each condition’s answer for the profile, with what it has, and whether it’s in. A merged profile answers for the profile it was merged into.