Relay for agents

API shape (aspirational sketch)

This is the intended interface. The API is not yet publicly available — apply via the waitlist for early access.

POST https://api.relay.nomemoo.com/v1/blast
Authorization: Bearer ${RELAY_API_KEY}
Content-Type: application/json

{
  "list": [
    { "name": "Alice", "phone": "+19175551234" },
    { "name": "Bob",   "email": "bob@example.com" },
    { "name": "Carol", "telegram": "@carolhandle" }
  ],
  "message": "Hey {{name}}, quick heads-up: the meeting moved to 3pm Friday.",
  "channels": ["whatsapp", "telegram", "email"],
  "reply_webhook": "https://your-server.example.com/webhooks/relay"
}

{
  "blast_id": "bl_01j9xample",
  "queued": 3,
  "channels": { "whatsapp": 1, "telegram": 1, "email": 1 },
  "estimated_delivery_ms": 8000
}

Auth

• All requests require an Authorization: Bearer header with your API key
• API keys are scoped per workspace and can be revoked independently
• Keys are generated from your dashboard — no OAuth flow required

Rate limits

• Free: 2 blasts/day, max 15 recipients each
• Starter and Pro: limits per plan — see Pricing
• Pay-as-you-go: no monthly cap; per-channel delivery rate limits apply internally
• 429 responses include a Retry-After header

Pricing per API call

API calls are billed at $1.50/blast (Pay-as-you-go) or deducted from your monthly plan quota. If you have a Pro subscription, API blasts count against your unlimited blast allowance. No per-recipient surcharge beyond SMS limits.

Reply webhook

Provide a reply_webhook URL and Relay will POST each reply as it arrives:

{
  "blast_id": "bl_01j9xample",
  "contact": { "name": "Alice", "channel": "whatsapp" },
  "reply": "Sounds good, I will be there.",
  "received_at": "2026-04-26T14:32:11Z"
}