For AI agents

Preview. API version 2026-11-15.

What this is

The Agent API is a monthly plan that a software agent can sign up for on behalf of a person or company, called the principal. The plan is meant to give the agent outreach channels of its own: calling, texting, email, WhatsApp and LinkedIn, starting with a phone number and a custom email domain. Leads are not part of the plan fee. Where lead pulls are offered, they are priced per lead. The principal is our customer and the sender of record for everything sent through the service.

Preview. The plan fee is charged from signup. The channels and lead pulls listed under notYetAvailable are not delivered yet.

Plans

There are three plans. Phone gives the agent a dedicated phone number for calls and text messages. Email gives it a sending domain registered for the principal, with its authentication records set up, and one mailbox. The Bundle includes both. Email and the Bundle carry a one-time setup charge for the domain. It is charged once: with the first month, or, when a Phone plan moves to the Bundle, at the time of the move. It is never charged again. A Phone or Email plan can move to the Bundle at any time through the API; the difference for the rest of the month is charged at once, with the one-time setup charge when the move is from Phone. Check what is delivered today, listed below, before you choose a plan. Prices and what each plan includes are in the discovery document.

Delivered today

  • Signup and hosted checkout
  • One API key per organization
  • Ideal customer profile storage
  • Plan, allowance and subscription status
  • Cancellation by API with 30 days notice
  • A phone number, with inbound calls to voicemail and inbound texts readable by API
  • Outbound texting to contacts with recorded consent
  • Outbound calls that speak a message, to numbers with recorded written call consent

Not delivered yet

These are described in the plan but the API does not serve them today. The plan fee is charged from signup whether or not an item here is ready, so read this list before you subscribe.

  • A custom email domain for sending email
  • WhatsApp
  • LinkedIn
  • Lead pulls, priced per lead
  • Connecting a call to the agent's own live voice system

How an agent signs up and calls the API

  1. Discover: GET this document.
  2. Choose a plan: phone, email or bundle (both channels; the default). pricing.plans lists what each includes and costs.
  3. Sign up: POST the signup body shown on the signup route (verified principal, agent identity, plan, termsVersion agent-v2, acceptTerms true). The response carries a hosted checkout URL and a checkoutSessionId.
  4. The principal pays at the hosted checkout URL, either a human or the principal's own payment step. The agent never sends card details to this API.
  5. Claim once: POST { "checkoutSessionId" } to the claim route after payment. The response carries the API key exactly once, so store it.
  6. Call the authenticated routes with the header Authorization: Bearer ai_<key>.
  7. While the account is active, replace the key with POST to the key rotation route, authenticated with the current key. If the key is lost, the principal asks us to reissue it; after we verify the request, claim again with the original checkoutSessionId.
  8. Cancel at any time with POST to the cancel route. Cancellation takes effect 30 days after the request.

Read the API