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

# [DNS Records] Create a new DNS record

> Create a new DNS record within a zone. Supported record types include A, AAAA, CNAME, MX, TXT, NS, SRV, CAA, and more. The record is immediately propagated to Cloudflare's global network. Certain record types have specific format requirements for their content field (e.g., MX requires priority, SRV requires priority/weight/port).



## OpenAPI

````yaml https://api.onetsolutions.net/schema post /v1/organizations/{organization_id}/projects/{project_id}/dns-zones/{id}/records
openapi: 3.0.3
info:
  title: OnetSolutions API
  version: v1 (v1)
  description: >

    ## Overview


    The OnetSolutions API provides programmatic access to manage your cloud
    infrastructure, domains, and web hosting services.


    ## Authentication


    All API requests require authentication using one of the following methods:


    - **JWT Token**: Obtain a token via login endpoints and include it in the
    `Authorization: Bearer <token>` header

    - **API Key**: Generate an API key from your account settings and use it as
    `Authorization: Bearer sk-onetsolutions-...`


    ## Rate Limiting


    API requests are rate-limited to ensure fair usage:

    - **Standard**: 1000 requests per minute

    - **Burst**: 100 requests per second


    ## Pagination


    List endpoints return paginated results. Use `page` and `page_size` query
    parameters.


    ## Error Handling


    The API uses standard HTTP status codes:

    - `200` Success

    - `201` Created

    - `400` Bad Request

    - `401` Unauthorized

    - `403` Forbidden

    - `404` Not Found

    - `429` Too Many Requests
servers:
  - url: https://api.onetsolutions.net
    description: Production
security: []
tags:
  - name: Authentication
    description: >-
      Login, passwordless authentication, MFA, OAuth providers, and token
      management.
  - name: Organizations
    description: >-
      Organization management, members, roles, modules, audit logs, and
      notification settings.
  - name: Projects
    description: Project management, team members, and project-scoped resources.
  - name: Compute
    description: >-
      Cloud instances, volumes, snapshots, backups, VPCs, firewalls, SSH keys,
      uptime monitors, and instance tasks.
  - name: Domains
    description: >-
      Domain availability, registration, transfers, DNS zones, DNS records, and
      TLD information.
  - name: Web Hosting
    description: >-
      cPanel-based web hosting, emails, databases, subdomains, FTP accounts,
      addon domains, and SSL certificates.
paths:
  /v1/organizations/{organization_id}/projects/{project_id}/dns-zones/{id}/records:
    post:
      tags:
        - Domains
      summary: '[DNS Records] Create a new DNS record'
      description: >-
        Create a new DNS record within a zone. Supported record types include A,
        AAAA, CNAME, MX, TXT, NS, SRV, CAA, and more. The record is immediately
        propagated to Cloudflare's global network. Certain record types have
        specific format requirements for their content field (e.g., MX requires
        priority, SRV requires priority/weight/port).
      operationId: create_dns_record
      parameters:
        - in: path
          name: id
          schema:
            type: string
          description: The unique identifier (UUID) of the DNS zone
          required: true
        - in: path
          name: organization_id
          schema:
            type: string
            format: uuid
          required: true
        - in: path
          name: project_id
          schema:
            type: string
            format: uuid
          required: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DNSRecordCreate'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DNSRecord'
          description: DNS record created successfully
        '400':
          description: >-
            Invalid record data. Check that the record type, name, and content
            are valid
        '401':
          description: Authentication credentials were not provided or are invalid
        '403':
          description: You do not have permission to create records in this DNS zone
        '404':
          description: DNS zone not found or does not belong to the specified project
        '409':
          description: A conflicting record already exists (e.g., duplicate CNAME)
      security:
        - BearerAuth: []
components:
  schemas:
    DNSRecordCreate:
      type: object
      properties:
        record_type:
          enum:
            - A
            - AAAA
            - CNAME
            - MX
            - TXT
            - NS
            - SRV
            - CAA
            - PTR
            - SOA
          type: string
          description: |-
            * `A` - A
            * `AAAA` - AAAA
            * `CNAME` - CNAME
            * `MX` - MX
            * `TXT` - TXT
            * `NS` - NS
            * `SRV` - SRV
            * `CAA` - CAA
            * `PTR` - PTR
            * `SOA` - SOA
          x-spec-enum-id: 82ebb21f608c0fd6
        name:
          type: string
          maxLength: 253
        content:
          type: string
        ttl:
          type: integer
          maximum: 86400
          minimum: 1
          default: 3600
        priority:
          type: integer
          maximum: 65535
          minimum: 0
          nullable: true
        proxied:
          type: boolean
          default: false
      required:
        - content
        - name
        - record_type
    DNSRecord:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        record_type:
          enum:
            - A
            - AAAA
            - CNAME
            - MX
            - TXT
            - NS
            - SRV
            - CAA
            - PTR
            - SOA
          type: string
          description: |-
            * `A` - A
            * `AAAA` - AAAA
            * `CNAME` - CNAME
            * `MX` - MX
            * `TXT` - TXT
            * `NS` - NS
            * `SRV` - SRV
            * `CAA` - CAA
            * `PTR` - PTR
            * `SOA` - SOA
          x-spec-enum-id: 82ebb21f608c0fd6
        name:
          type: string
          maxLength: 253
        content:
          type: string
        ttl:
          type: integer
          maximum: 4294967295
          minimum: 0
          format: int64
        priority:
          type: integer
          maximum: 4294967295
          minimum: 0
          format: int64
          nullable: true
        proxied:
          type: boolean
        created:
          type: string
          format: date-time
          readOnly: true
        modified:
          type: string
          format: date-time
          readOnly: true
      required:
        - content
        - created
        - id
        - modified
        - name
        - record_type
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT or API Key
      description: >-
        Use `Authorization: Bearer <token>` header. Token can be a JWT token or
        an API key (format: `sk-onetsolutions-...`).

````