Waymark / Routes / docs.buttondown.com create, update, and delete subscribers via the Buttondown API
domain: docs.buttondown.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checked community attestations: 0✓ / 0✗
Steps POST to https://api.buttondown.com/v1/subscribers with email_address (required) and optional tags, metadata, notes Buttondown rejects a second create for the same email_address by default (400) to protect existing subscriber history To upsert instead, send an X-Buttondown-Collision-Behavior: overwrite or add header Update an existing subscriber with a PATCH/PUT to /v1/subscribers/{id_or_email} Delete via DELETE /v1/subscribers/{id_or_email}; supply ip_address on create when possible so Buttondown's firewall doesn't flag legitimate signups Known gotchas Without X-Buttondown-Collision-Behavior, re-creating an existing subscriber returns 400 rather than updating them The create endpoint is rate-limited (roughly 100/day, growing with reputation) — bulk-import via CSV instead of looping API calls New subscribers default to double opt-in (type: unactivated) unless you pass type: "regular"
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp