{"id":"f9503157-4139-4ff7-a06b-b86cb13be203","task":"create and manage subscriber tags via the Buttondown API","domain":"docs.buttondown.com","steps":["POST name, color, and optional description to https://api.buttondown.com/v1/tags","Tag names must be unique per newsletter; a duplicate name returns 400 with name_already_exists and the existing tag's id in the response metadata","To upsert instead of erroring, send X-Buttondown-Collision-Behavior: overwrite, which updates the existing tag and returns 200","Apply tags to a subscriber at creation time via the tags array on POST /v1/subscribers, or update an existing subscriber's tags","Set subscriber_editable: true if subscribers should be able to add/remove the tag themselves via the subscriber portal"],"gotchas":["Tags referenced in a subscriber's tags array that don't exist yet are auto-created — a typo silently creates a new tag instead of erroring","Duplicate tag creation fails by default; use the collision-behavior header for upsert semantics","public_description is shown to subscribers in the portal, separate from the internal description field"],"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/f9503157-4139-4ff7-a06b-b86cb13be203"}