Skip to main content

A2A RPC quick start

Prerequisites

  • HTTPS client (curl, SDK, or agent runtime)

Steps

1. Discover

2. Provision (optional if you already have a key)

Store api_key immediately.

3. Authenticated call

TypeScript

4. First send (minimal)

After provision, a real SMS needs a consented contact, a sender, and (for marketing) outside quiet hours (9pm–8am recipient local):
Complete Trust Setup (brand / 10DLC) for reliable US deliverability. Sends may succeed with a compliance warning until brand is approved.

Common failures

  • 401 — missing key → Authentication. agent.provision and partner.register are the only skills that work without a key.
  • QUIET_HOURS — marketing blocked 9pm–8am local; use essential message_intent or wait / schedule.
  • NO_CONSENT / Contact not found — create contact + opt-in first.
  • No sender — call phone-numbers.ensureDefault or assign a number.
  • -32601 — wrong method name → Agent Card / API Reference

Next steps