{"id":"9f17f167-12b2-4858-8e3d-78de8fee009d","task":"manage beehiiv custom fields via the API","domain":"developers.beehiiv.com","steps":["List existing fields with GET /v2/publications/:publicationId/custom_fields to avoid duplicate names","Create a field with POST .../custom_fields, specifying kind (e.g. string, list) and a display name","For dropdown/list-kind fields, supply the options array","Reference the field's name (not id) in Create/Update Subscription's custom_fields array to set values","Update or delete fields via PUT/PATCH/DELETE on .../custom_fields/:id"],"gotchas":["custom_fields values sent on subscription create/update calls are matched by name and silently dropped if the field doesn't already exist","custom_fields:write and custom_fields:read are distinct OAuth scopes","Deleting a field removes its data from all subscribers with no undo"],"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/9f17f167-12b2-4858-8e3d-78de8fee009d"}