---
title: "Create a DiscoLike account for a human (agent-initiated)"
method: POST
path: "/public/signup"
tags: ["Signup"]
---

# Create a DiscoLike account for a human (agent-initiated)

`POST /public/signup`

## Request

- Base URL: `https://api.discolike.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.discolike.com/public/signup`
- Auth: none declared

Creates a DiscoLike user and organization for the given work email without any browser interaction. No credential is returned: the account owner receives a confirmation email and logs in at https://app.discolike.com, where they can issue API keys. Free-mail and disposable domains are rejected.

## Request body

- PublicSignupRequest: Body for POST /public/signup.
  - `email` string, required: The human's work email; becomes the login
  - `first_name` string, required: 1-40 characters after trimming and NFC normalization; must contain a letter; no angle brackets or control characters
  - `last_name` string, required: 1-40 characters after trimming and NFC normalization; must contain a letter; no angle brackets or control characters
  - `agent` string, nullable: Name of the agent or framework making the call, e.g. claude-code. Defaults to the User-Agent header.

## Response `201`

Successful Response

- PublicSignupResponse
  - `status` string, required: created
  - `email` string, required
  - `org_domain` string, required: Organization domain, derived from the email
  - `org_status` string, required: created when a new organization was made, joined when one already existed
  - `next_step` string, required: Human-readable instruction to relay to the account owner

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-03** `2c66dc81da4b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/discolike/apis/discolike-api/changes/public/signup/post.md)

---

[API](https://skmtc.dev/discolike/apis/discolike-api.md) - [All operations](https://skmtc.dev/discolike/apis/discolike-api/llms.txt) - [OpenAPI document](https://skmtc.dev/discolike/apis/discolike-api/revisions/7f9a7b84671b?raw)
