> ## Documentation Index
> Fetch the complete documentation index at: https://jetemail.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Add new domain

> Adds a new domain for sending email



## OpenAPI

````yaml /openapi.json post /outbound/domains
openapi: 3.0.0
info:
  title: JetEmail API
  version: 1.0.0
  description: API documentation for JetEmail's transactional email service.
servers:
  - url: https://api.jetemail.com
    description: Production
security:
  - apiKeyAuth: []
externalDocs:
  description: Download OpenAPI Specification
  url: /openapi.json
paths:
  /outbound/domains:
    post:
      tags:
        - Outbound
      summary: Add new domain
      description: Adds a new domain for sending email
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - domain
              properties:
                domain:
                  type: string
                  description: Domain name to add
                  example: example.com
                  pattern: >-
                    ^(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?.)+[a-zA-Z]{2,}$
      responses:
        '200':
          description: Domain added successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Domain added successfully
                  domain:
                    type: string
                    description: The added domain name
                    example: example.com
                  uuid:
                    type: string
                    description: Unique identifier for the domain
                    example: 550e8400-e29b-41d4-a716-446655440000
                  status:
                    type: integer
                    description: Domain status code
                    example: 0
                  created_date:
                    type: integer
                    description: Creation timestamp
                    example: 1735689600
                  dns:
                    type: object
                    properties:
                      dkim:
                        type: object
                        properties:
                          host:
                            type: string
                            description: DKIM record hostname
                            example: jetemail._domainkey.example.com
                          value:
                            type: string
                            description: DKIM record value
                            example: dkim.jetsmtp.net
                          verified:
                            type: boolean
                            description: Whether the DKIM record is verified
                            example: false
                      spf:
                        type: object
                        properties:
                          host:
                            type: string
                            description: SPF CNAME record hostname
                            example: em12345.example.com
                          value:
                            type: string
                            description: SPF CNAME record target
                            example: return.jetsmtp.net
                          type:
                            type: string
                            description: DNS record type
                            example: CNAME
                          verified:
                            type: boolean
                            description: Whether the SPF record is verified
                            example: false
                      dmarc:
                        type: object
                        properties:
                          host:
                            type: string
                            description: DMARC record hostname
                            example: _dmarc.example.com
                          value:
                            type: string
                            description: DMARC record value
                            example: v=DMARC1; p=none
                          verified:
                            type: boolean
                            description: Whether the DMARC record is verified
                            example: false
        '400':
          description: Bad Request - Invalid domain format
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: Invalid domain format
        '401':
          description: Unauthorized - User not authenticated
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: User information not found
        '409':
          description: Conflict - Domain already exists
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: Domain already exists
        '500':
          description: Server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: Failed to add domain
components:
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      description: API key for account management endpoints. Use your api_ prefixed token.

````