A phone call API for AI agents

Give your agent a phone line. Agents notify the device they run on; DoNotify rings an actual number, so yours can reach someone who is not holding a screen. Works with Meta Muse, Grok Bot, OpenClaw, or anything that can make an HTTP request.

Why AI agents cannot make phone calls

Your agent can draft the email, book the table, and remember the appointment. When it needs a human to actually know something, it has one move: a notification on the device it lives on. That reaches the owner, if the owner is looking.

It cannot ring a phone. So it cannot reach the user when their phone is in a bag, and it cannot reach anyone else at all: not a patient, not a customer, not the user's mother about her tablets. There is no app to install on the other end of a landline.

DoNotify is the missing verb. One API call and a real phone rings, speaks your message, and reports what happened. Immediately, or scheduled for later.

Install the skill

Two files. Hand your agent whichever one its platform takes and it works out the rest, including when a call is warranted and when a notification will do.

SKILL.md

For Grok Bot skills, Claude and OpenClaw, and any agent that reads a skill file.

/agent-skills/donotify/SKILL.md

openapi.json

For Meta Muse connectors and anything else that takes an OpenAPI document.

/agent-skills/donotify/openapi.json
  1. Create an API token in your DoNotify profile.
  2. Give your agent the file above, plus the token as DONOTIFY_API_TOKEN.
  3. Say "call me in ten minutes so I leave on time" and answer your phone.

Which AI agents can place phone calls

Meta Muse

Muse takes third-party connectors, and Muse Spark handles new tools, MCP servers and custom skills without bespoke training. Point a connector at the API reference below and Muse works out when to use it. Ask it to call you and your phone rings.

Give it the endpoints below as the service definition, plus your API token.

Grok Bot

Grok Bots carry their own skills and integrations, and a tuned bot can be shared as a template. Add DoNotify as an outbound HTTP skill so your bot can escalate from a message to a call when something actually needs a person.

Useful for on-call and reminder bots, where a Slack message at 3am reaches nobody.

OpenClaw

There is a packaged DoNotify skill for OpenClaw already, with setup instructions and example commands.

Open the OpenClaw setup guide

Anything else

Three JSON endpoints and a bearer token. If your agent framework can make an HTTP request, whether that is a custom tool definition, a function call, or a shell step, it can place a phone call. No SDK required.

Phone call API reference

Every request carries Authorization: Bearer YOUR_API_TOKEN and Accept: application/json. Base URL is https://donotifys.com.

Check what is left

Call this first. If phone_number_set is false, tell the user to add their number before trying to call.

GET /api/usage

{
  "plan": "starter",
  "notification_limit": 30,
  "used_this_month": 5,
  "remaining": 25,
  "phone_number_set": true
}

Call now

Rings the user's phone straight away and speaks the title, then the description.

POST /api/call-now
Content-Type: application/json

{
  "title": "Your 3pm call starts in ten minutes",
  "description": "Dial-in details are in the calendar invite"
}

{
  "success": true,
  "reminder_id": 42,
  "call_uuid": "abc-123",
  "status": "completed"
}

Schedule a call

Books a call for a future time. call_at is when the phone rings; event_time is the thing being remembered, if the two differ.

POST /api/reminders
Content-Type: application/json

{
  "title": "Take blood pressure tablets",
  "call_at": "2026-10-01T08:00:00Z",
  "description": "The white box on the kitchen counter"
}

Calls are placed to the phone number on the DoNotify account the token belongs to. An agent cannot dial arbitrary numbers, which is deliberate: it keeps a compromised or confused agent from cold-calling strangers.

Worth telling your agent

Agents tend to over-reach for a new tool. A line or two in the system prompt keeps calls rare and useful: 

Use DoNotify only when the user must actually be interrupted:
a deadline they will miss, a dose that matters, an escalation
nobody has acknowledged. Check /api/usage first. For anything
routine, a normal notification is the right choice.

A ringing phone is the loudest thing an agent can do. Spend it carefully and people keep answering.

Common questions

Is there an API to make phone calls from an AI agent?

Yes. Three JSON endpoints: GET /api/usage to check what is left, POST /api/call-now to ring the phone immediately, and POST /api/reminders to schedule one. Each carries a bearer token, so any agent that can make an HTTP request can place a call. No SDK.

Can Meta Muse make a phone call?

Not on its own. Muse speaks to you through its app, smart glasses or the Charm device, so it reaches whoever is holding the hardware. It does accept third-party connectors, so pointing one at this API gives it the ability to ring an actual number.

Can a Grok Bot call my phone?

A Grok Bot carries its own skills and integrations, so adding an outbound HTTP call here lets it escalate from a chat message to a ringing phone. Useful for on-call and reminder bots, where a message sent at 3am reaches nobody.

Can an AI agent call any phone number?

Not with DoNotify. Calls go to the number on the account the token belongs to. That limit is deliberate: it stops a confused or compromised agent cold-calling strangers.

What does an automated phone call API cost?

14 calls free with no credit card, then from $7.50 a month for up to 50 calls. Pricing is flat monthly rather than per minute, so an agent placing calls does not produce a bill that moves.

Let your agent pick up the phone

Create an API token and wire it into your agent in minutes.

Get Started Free

14 free reminders included • No credit card required