---
title: "Create an email-based organization"
method: POST
path: "/orgs/v1/email"
tags: ["Billing"]
---

# Create an email-based organization

`POST /orgs/v1/email`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/orgs/v1/email`
- Auth: none declared

Creates an organization identified by email (Stripe-only, no wallet). Idempotent — duplicate emails return the existing organization. Email verification links are currently disabled; responses include verification_sent: false and verification_supported: false.

## Request body

- object
  - `email` string, email, required

## Response `201`

Organization created

- OrganizationCreated
  - `id` string, required
  - `email` string, email, required
  - `email_credits_remaining` integer, required
  - `verification_sent` boolean, required: False while billing-email verification links are disabled
  - `verification_supported` boolean, required: Whether billing-email verification links are currently supported

## Other responses

- `400`: Invalid email
- `429`: Verification rate limited

---

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