Skip to main content
POST
This endpoint requires an organization admin API key (ASA_ prefix). Standard project API keys cannot access this endpoint.

Authorizations

Authorizations
string | header
required
Organization admin API key header of the form Bearer ASA_<key>. Standard project API keys (AS_ prefix) will receive a 403 error.

Body

name
string
required
Name of the project (max 100 characters).Maximum length: 100Example: "My New Project"
domain
string
Domain name through which you plan to send emails, without the https:// prefix. Accepts a root domain (e.g., example.com) or a subdomain (e.g., mail.example.com).Example: "example.com"
regionKey
string
Account region where the project data will be stored.Allowed values: us-east-1, us-east-2, ap-south-1, eu-central-1Example: "us-east-1"

Response

Project created successfully (201)
success
boolean
Indicates if the request was successfulExample: true
data
object
The created project object

Error Responses

403 - Not an admin key
object
Returned when using a standard project API key instead of an organization admin API key.
403 - Plan limit reached
object
Returned when the organization has reached its plan’s project limit.