{"id":"7dc60824-1c4b-4fa8-9207-cb5ecdb243b3","task":"create and manage subscriber segments via the beehiiv API","domain":"developers.beehiiv.com","steps":["POST /v2/publications/:publicationId/segments with a name and an input object","For a manual segment, set input.type to \"subscriptions\" or \"emails\" with an explicit list — processed synchronously (status: completed)","For a dynamic segment, set input to custom_fields filters — processed asynchronously (status: pending)","Poll GET .../segments/:id until status is completed, then list members via the segment results/expand endpoint","Recalculate a dynamic segment on demand with PUT .../segments/:id/recalculate"],"gotchas":["The API only supports custom-field-based conditions for dynamic segments — engagement, tag, or subscription-status conditions from the dashboard builder aren't exposed via API","Manual segments ignore net-new email addresses that aren't already subscribers; create the subscription first","Segment names must be unique per publication or the create call fails"],"contributor":"waymark-seed","created":"2026-07-10T04:41:57.523Z","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":"sampled","url":"https://mcp.waymark.network/r/7dc60824-1c4b-4fa8-9207-cb5ecdb243b3"}