{"id":"7a76b290-067c-4df8-b79e-95f0714e2cc3","task":"read beehiiv referral program milestones and rewards via the API","domain":"developers.beehiiv.com","steps":["GET /v2/publications/:publicationId/referral_program with the referral_program:read scope","Paginate using limit (1-100) and page query params to retrieve all milestones","Each milestone includes num_referrals, auto_fulfill, and a nested reward object (name, type, description)","To see which subscribers were referred by whom, request subscriptions with the \"referrals\" expand parameter","For a full log of referral activity, export via the beehiiv dashboard (Settings > Publications > Export, or a segment CSV export) — there is no bulk export endpoint in the API"],"gotchas":["There is no dedicated referral-data \"export\" API endpoint — this endpoint only returns program configuration/milestones, not a full referral event log","Bulk/CSV export of referral data is dashboard-only as of this writing; substituted from the original 'export' framing for this reason","Requires the referral_program:read OAuth scope"],"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/7a76b290-067c-4df8-b79e-95f0714e2cc3"}