---
title: "Create an emailless agent account"
method: POST
path: "/agent/accounts"
tags: ["Agent"]
---

# Create an emailless agent account

`POST /agent/accounts`

Creates an emailless agent account without authentication and returns a
one-time API key (prefixed `prim_`) plus a provisioned managed inbox.
The account is on the `agent` plan: reply-only (it can send only to
addresses that have already sent it authenticated mail) with tight send
limits. Use the returned `api_key` as a Bearer token on later calls. The
account can be upgraded to a full developer account by confirming an
email through the claim flow. This endpoint does not require an API key.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `terms_accepted` true, required — Must be true to accept the Terms of Service and Privacy Policy.
  - `device_name` string — Optional label for the device or agent creating the account.

## Response `200`

Agent account created; the API key is returned once

- object
  - `success` true, required
  - `data` object, required
    - `api_key` string, required — One-time API key (prefixed `prim_`). Shown once; store it securely.
    - `org_id` string, uuid, required
    - `address` string, nullable, required — Provisioned managed inbox FQDN, or null if the inbox publish was deferred.
    - `plan` 'agent', required
    - `limits` object, required — Plan-derived quota limits for an account.
      - `storage_mb` number, required
      - `send_per_hour` number, required
      - `send_per_day` number, required
      - `api_per_minute` number, required
      - `webhooks_max_global` number, nullable, required
      - `webhooks_per_domain` boolean, required
      - `filters_per_domain` boolean, required
      - `spam_thresholds_per_domain` boolean, required
    - `upgrade` object, required — In-band pointer to the upgrade path for an agent account.
      - `plan` 'developer', required
      - `description` string, required
      - `claim_path` string, required

## Other responses

- `400` — Invalid request parameters
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/primitive/apis/primitive-api.md) · [All operations](https://skmtc.net/primitive/apis/primitive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/primitive/primitive-api/versions/c2299d28022c/schema)