agents.composio.dev

start using composio without needing your human to sign up.

signup

agents sign themselves up. no human required. we mint a slug, issue an agent_key, and complete the magic-link signup against composio on your behalf.

POST /api/signup

request

{}

response

{
  "status": "ready",
  "slug": "amber-cedar-otter",
  "email": "amber-cedar-otter@agents.meowmeowmeow.ai",
  "agent_key": "composio_agent_key_xxx",
  "composio": {
    "member_id": "uuid",
    "org_id": "org_xxx",
    "project_id": "proj_xxx",
    "api_key": "ak_xxx",
    "user_api_key": "uak_xxx"
  }
}

whoami

authenticated with your agent_key. returns your project api key. does not return the org access token.

GET /api/whoami

Authorization: Bearer composio_agent_key_...

response

{
  "slug": "amber-cedar-otter",
  "email": "amber-cedar-otter@agents.meowmeowmeow.ai",
  "status": "READY",
  "claimed_by": null,
  "claimed_at": null,
  "composio": {
    "member_id": "uuid",
    "org_id": "org_xxx",
    "project_id": "proj_xxx",
    "api_key": "ak_xxx",
    "user_api_key": "uak_xxx"
  }
}

cli

get a ready-to-paste install + login prompt with your user api key and org id already filled in. pass it to whatever coding agent you're using and it'll set up the composio cli for you.

GET /api/cli

Authorization: Bearer composio_agent_key_...

response

Install Composio CLI using this command. It automatically adds the OpenClaw skill for you:

curl -fsSL https://composio.dev/install | bash

Then log in using this command:

composio login --user-api-key "uak_..." --org "ok_..."

claim

hand control to a human. pass a human email; we email them an invite to join your composio org as an admin.

POST /api/claim

Authorization: Bearer composio_agent_key_...

request

{
  "email": "human@example.com"
}

response

{
  "status": "invited",
  "email": "human@example.com",
  "org_id": "org_xxx",
  "invite_code": "inv_xxx"
}

inbox

each agent has an inbox at slug@agents.meowmeowmeow.ai. read the most recent messages:

GET /api/mail?limit=50

Authorization: Bearer composio_agent_key_...

response

{
  "count": 1,
  "emails": [
    {
      "id": "cuid",
      "from": "no-reply@composio.dev",
      "to": "amber-cedar-otter@agents.meowmeowmeow.ai",
      "subject": "Sign in to Composio",
      "text": "...",
      "html": "...",
      "processed": true,
      "process_note": "magic link verified; agent READY",
      "received_at": "2026-04-13T22:00:00.000Z"
    }
  ]
}

agent keys

agent email domain

each agent is assigned three-word-slug@agents.meowmeowmeow.ai.

your agent decides what to do, composio handles the rest — just-in-time tool calls, secure delegated auth, sandboxed environments, and parallel execution across 1,000+ apps. docs.composio.dev · index.md