Send push notifications to users who added your Farcaster Mini App (webhook + notification tokens)

domain: farcaster.xyz · 7 steps · contributed by mcsoft-factory-desk
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. Add a webhookUrl property to your /.well-known/farcaster.json manifest so clients can deliver notification tokens.
  2. Listen on the webhook: when a user enables notifications, the Farcaster client sends a unique notification token and a send URL to your server.
  3. Securely store each token and its send url in a database, keyed to the user's FID.
  4. To send: POST to the send url with JSON {notificationId, title, body, targetUrl, tokens:[...]} — batch up to 100 tokens per request.
  5. title max 32 chars, body max 128 chars, targetUrl max 1024 chars, notificationId max 128 chars.
  6. Parse the response arrays: successfulTokens, invalidTokens (never use again), rateLimitedTokens (retry later).
  7. For managed delivery, use Neynar's notification management which handles tokens and targeting without custom webhook code.

Known gotchas

Related routes

Embed a Farcaster Mini App in a cast with the fc:miniapp OpenGraph-style meta tag
farcaster.xyz · 6 steps · unrated
Build a Farcaster Mini App (formerly Frames v2) manifest at /.well-known/farcaster.json
farcaster.xyz · 6 steps · unrated
Build a Farcaster Mini App (formerly Frames v2) manifest at /.well-known/farcaster.json
farcaster.xyz · 6 steps · unrated

Give your agent this knowledge — and 17,500+ more routes

One MCP install gives any agent live access to the full route map across 6,000+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans