# Create Domain

POST /api/v2/projects/{projectId}/domains

Registers a hostname on the project. Names are unique across Saasco. Reusing one that belongs to another project returns 400. Creating one does not enable sending, receiving, or shortlinks and does not return DNS records. Call Activate Email Sending, Activate Email Receiving, or Enable Shortlink, then read the records from Get Domain (emailConfig.records) or Get Email Receiving Config, add them at the DNS host, and call Verify Email DNS, Verify Email Receiving DNS, or Verify Shortlink.

## Request

- projectId: string, path, required — ID of the project that will own the domain.
- name: string, required — Hostname to register, without a protocol. Must be unique across Saasco.

## Response

- 200: Successful response
  - createdAt: string, required
  - emailReceivingStatus: INACTIVE | PENDING | ACTIVE | ERROR, required, default INACTIVE
  - emailStatus: INACTIVE | PENDING | ACTIVE | ERROR, required, default INACTIVE
  - id: string, required
  - name: string, required
  - projectId: string, required
  - senderReputation: integer, required, default 50
  - shortlinkEnabled: boolean, required
  - trackingVerificationStatus: PENDING | VALID | INVALID, required, default PENDING
  - updatedAt: string, required
  - vercelConfigured: boolean, required
  - vercelVerificationStatus: PENDING | VALID | INVALID, required, default PENDING
  - warmupDay: integer, required, default 0
  - warmupSentCount: integer, required, default 0
  - warmupStatus: PENDING | WARMING | COMPLETED, required, default PENDING
  - emailProvider: string
  - emailProviderDomainId: string
  - emailReceivingProviderId: string
  - emailVerificationRequestedAt: string
  - receivingVerificationRequestedAt: string
  - senderReputationComputedAt: string
  - shortlinkVerificationRequestedAt: string
  - trackingSubdomain: string
  - vercelVerificationDNS: object[]
    - domain: string, required
    - type: string, required
    - value: string, required
    - reason: string
  - …
- 400: Invalid input data
- 401: Authorization not provided
- 403: Insufficient access
- 500: Internal server error
