---
title: "POST /openclaw/signup"
method: POST
path: "/openclaw/signup"
---

# POST /openclaw/signup

`POST /openclaw/signup`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/openclaw/signup`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Request body

- object: Input for self-service agent and organization registration via OpenClaw
  - `openclawAgentId` string, required: OpenClaw agent identifier to register
  - `organizationName` string, required: Display name for the new organization
  - `organizationSlug` string, required: URL-friendly organization slug (lowercase alphanumeric and hyphens)
  - `agentName` string, required: Display name for the agent
  - `agentSlug` string, required: URL-friendly agent slug (lowercase alphanumeric and hyphens)
  - `email` string, email, required: Primary email address for the agent
  - `phoneNumber` string, required: Phone number to provision for the agent
  - `metadata` object: Additional metadata for the signup

## Response `200`

OK

- object: Result of a successful self-service signup including organization, agent, and credentials
  - `organization` object, required: Newly created organization details
    - `id` string, required: Unique organization identifier
    - `name` string, required: Organization display name
    - `slug` string, required: Organization URL slug
    - `tier` 'FREE' | 'STARTER' | 'GROWTH' | 'ENTERPRISE', required: Subscription tier assigned to the organization
    - `createdAt` string, date-time, required: Timestamp when the organization was created
  - `agent` object, required: Newly created agent details
    - `id` string, required: Unique agent identifier
    - `orgId` string, required: Organization the agent belongs to
    - `name` string, required: Agent display name
    - `slug` string, required: Agent URL slug
    - `email` string, email, required: Agent email address
    - `phoneNumber` string, required: Provisioned phone number
    - `apiKeyPrefix` string, required: Prefix of the generated API key for identification
    - `createdAt` string, date-time, required: Timestamp when the agent was created
  - `credentials` object, required: API credentials for the new agent
    - `apiKey` string, required: Full API key (shown only once)
    - `apiKeyPrefix` string, required: API key prefix for future identification

---

[API](https://skmtc.dev/useanima/apis/anima-api.md) · [All operations](https://skmtc.dev/useanima/apis/anima-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useanima/apis/anima-api/revisions/aaa148188980?raw)