---
title: "Create a Definite signup and send an email verification code"
method: POST
path: "/onprem/v1/hosted-signups"
tags: ["onprem", "onprem", "__public__"]
---

# Create a Definite signup and send an email verification code

`POST /onprem/v1/hosted-signups`

## Headers

- `X-Definite-Hosted-Signup-Token` string, nullable

## Request body

- HostedSignupRequest
  - `email` string, required — Signup email address
  - `company_name` string, required — Company or workspace name
  - `requested_slug` string, nullable — Optional requested customer slug
  - `hosting_mode` 'definite_cloud' | 'self_hosted' — Whether Definite should host the stack or only provide self-hosted setup instructions
  - `terms_accepted` boolean, required — Whether the user accepted Definite signup terms

## Response `200`

Success

- SuccessResponseHostedSignupResponse
  - `success` true, required — Flag for it request was successful
  - `data` HostedSignupResponse, required
    - `signup_id` union, required
      - string, uuid
      - string
    - `status_token` string, required
    - `status` 'email_pending' | 'approval_pending' | 'accepted' | 'rejected' | 'converted', required
    - `hosting_mode` 'definite_cloud' | 'self_hosted', required
    - `email_domain_kind` 'unknown' | 'business' | 'free', required
    - `approval_status` 'not_required' | 'pending' | 'approved' | 'rejected', required
  - `meta` ResponseMeta
    - `requestId` string — Unique request identifier for tracing
    - `timestamp` string, date-time — Response timestamp (UTC)
    - `durationMs` integer, nullable — Request processing time in milliseconds

## Other responses

- `400` — Validation Bad Request
- `401` — Auth Invalid Token
- `403` — Forbidden Insufficient Permissions
- `422` — Validation Failed
- `426` — Business Quota Exceeded
- `500` — Internal Error

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/3943d8deb3be/schema)