> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitsearch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Let Your Agent Sign Up

> Your AI agent creates its own Orbit workspace and starts searching at once. You join it later by signing up with your email.

Your agent can start using Orbit before you do anything. It signs up with your
email, gets its own API key and free credits, and starts searching right away.
When you sign up for Orbit with that email, the workspace is yours.

## How It Works

**1. Your agent signs up**

The agent sends your email and its own name to
[`POST /v3/agents/signup`](https://docs.orbitsearch.com/api/agents/signup), or calls `orbit_signup` over
[MCP](https://docs.orbitsearch.com/mcp-server.md#connect-an-agent-without-signing-in). Orbit creates a
workspace with the signup credits and returns an API key for the agent.

**2. Your agent works**

The agent uses its key for Search, Enrich, and profile reads, like any other
key. You don't need to sign in, paste a key, or approve anything.

**3. You sign up**

Your agent gives you a sign-up link. Sign up with the same email, using
Google or email, as you would anyway. Orbit adds you to the workspace as its
owner. The agent's key keeps working.

**4. You share credits**

Add credits on the [Billing](https://developer.orbitsearch.com/dashboard/billing)
page. You and your agent draw from the same balance, and you can see and
revoke the agent's key in the dashboard.

Orbit doesn't email or contact you. The email your agent uses only decides who
the workspace belongs to.

## Sign Up

```bash theme={"dark"}
curl -X POST "https://api.orbitsearch.com/v3/agents/signup" \
  -H "Content-Type: application/json" \
  -d '{ "email": "jane@company.com", "agent_name": "Claude Code" }'
```

```json theme={"dark"}
{
  "status": "success",
  "agent_signup": {
    "status": "unclaimed",
    "organization_id": "0b6f7c55-3c1e-4c2b-8f4a-5d7e9a1b2c3d",
    "email": "jane@company.com",
    "api_key": "sk_orb_REDACTED",
    "api_key_scopes": ["search:read", "profile:read"],
    "signup_credits": 200,
    "sign_up_url": "https://developer.orbitsearch.com/signup"
  }
}
```

The `api_key` appears only in this response. Store it in your agent's private
credential storage, and send it as `Authorization: Bearer sk_orb_...` on every
request. Never show it to the person or put it in a message.

Give the person `sign_up_url` and ask them to sign up with the email you used.
Do it when it helps, and always when credits run out: a request that needs more
credits than the workspace has returns `402` with
`developer_api_credits_insufficient`.

## Rules

* **One signup per email.** Each email address gets one agent workspace and one
  set of signup credits. Gmail dots and `+tags` count as the same address. A
  person who signs up with that email shares the workspace's credits instead of
  getting a second grant.
* **Existing accounts sign in.** If the email already has an Orbit account,
  signup returns `409` with `agent_signup_email_has_account`. Ask the person to
  sign in and connect you, for example with the
  [MCP server](https://docs.orbitsearch.com/mcp-server.md).
* **Real email addresses only.** Disposable and example domains return `400`
  with `agent_signup_email_not_allowed`.
* **Only that email joins.** The workspace goes to whoever signs up or signs in
  with the verified email the agent used, and to no one else.

> [!NOTE]
>
> The agent's key has the `search:read` and `profile:read` scopes. Directory
> management, members, and billing need the person's own sign-in.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.