Build custom integrations with the CustomAgents REST API, webhooks, and hosted MCP server.

Quick start

Everything is available over a standard REST API, authenticated with a bearer key. Generate a key in the dashboard under Settings → API Keys, then:

# List your agents
curl https://api.customagents.io/v1/agents \
  -H "Authorization: Bearer ca_acct_YOUR_KEY"

Prefer to work from an IDE or an AI assistant? Connect the hosted MCP server and drive your account from Claude, Cursor, or VS Code — no client library to install.

Resources

API Reference

Full REST API documentation with endpoints, parameters, and examples

Connect an IDE (MCP)

Control your whole account from Claude, Cursor, VS Code or ChatGPT — send email and SMS via the Model Context Protocol

API keys & scopes

Create scoped account keys, set spend caps, and understand the least-privilege scope model

Per-agent API & MCP

Mint a key pinned to a single agent for tightly-scoped automations

Webhooks

Real-time event notifications for inbox and message events

Authentication

All API requests require an API key passed in the Authorization header:

curl https://api.customagents.io/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY"

API keys are generated in the dashboard under Settings > API Keys.

Rate limits are enforced per API key, not per plan. Read routes get roughly 600 requests/minute, writes roughly 60/minute, and money-spending routes roughly 20/minute. Exceeding a bucket returns 429 Too Many Requests. See the API Reference for details.

Developers