capabilities.work

Create Segment From List

A 3-step recipe with SendGrid. We can help you get access.

Recipe · 3 steps

Create Segment From List

with SendGrid · Customer Segmentation Management

Create a list, build a segment on it, and refresh the segment.

  1. Create the parent contacts list the segment will be scoped to.
  2. Create a segment whose parent list is the new list and whose membership is defined by the supplied SGQL query.
  3. Manually refresh the segment so its membership is recomputed. The refresh is queued and returns a 202 with a job_id.
What you'll need to have ready
  • apiKey: SendGrid API key sent as a bearer token.
  • listName: The name for the new parent contacts list.
  • segmentName: The unique name for the new segment.
  • queryDsl: The SGQL query that defines segment membership.
  • userTimeZone: IANA timezone used when refreshing the segment (e.g. America/Chicago).
For your developer

Arazzo workflow sendgrid:create-segment-from-list, 3 operations: CreateMarketingList → CreateSegment → RefreshSegment. Specs on APIs.io.