Quick tipDeveloperSmart CRM

Read and change segment memberships with the API

Only manual and snapshot segments take manual adds.

Subscription
All tiers
Permissions
Lists scopes
Time
4 min · Intermediate
Last verified

Short answer

HubSpot's developer docs: segments have three processingType values. DYNAMIC segments are filter-based and HubSpot adds and removes records as they change. MANUAL segments only change by user or API. SNAPSHOT segments process filters once, then only change manually. New segments return an ILS listId.

1. In the app

Segment types in my demo portal.

Segments list with the Type column showing Active highlighted
The Type column shows Active for each segment.

2. The calls

GET /crm/v3/lists/{listId}/memberships
PUT /crm/v3/lists/{listId}/memberships/add        body: ["123", "456"]
PUT /crm/v3/lists/{listId}/memberships/add-from/{sourceListId}

Paths shown in v3 form; the docs list dated API versions too.

3. Related

Active vs static segments.

Sources

New field notes by email

One email when a new article publishes.

Still stuck?

If this did not fix it, the problem is probably specific to your setup. Book a call and we will look at it together.

Book a call with Sam