---
title: "Create an FQDN"
method: POST
path: "/fqdns"
tags: ["FQDNs"]
---

# Create an FQDN

`POST /fqdns`

Create a new FQDN object.

## Request body

- CreateFqdnRequest
  - `connection_id` string, required — ID of the FQDN connection to which this IP should be attached.
  - `fqdn` string, required — FQDN represented by this resource.
  - `port` integer, nullable — Port to use when connecting to this FQDN.
  - `dns_record_type` string, required — The DNS record type for the FQDN. For cases where a port is not set, the DNS record type must be 'srv'. For cases where a port is set, the DNS record type must be 'a'. If the DNS record type is 'a' and a port is not specified, 5060 will be used.

## Response `201`

Successful response with details about an FQDN connection.

- object
  - `data` Fqdn
    - `id` string — Identifies the resource.
    - `record_type` string — Identifies the type of the resource.
    - `connection_id` string — ID of the FQDN connection to which this FQDN is attached.
    - `fqdn` string — FQDN represented by this resource.
    - `port` integer — Port to use when connecting to this FQDN.
    - `dns_record_type` string — The DNS record type for the FQDN. For cases where a port is not set, the DNS record type must be 'srv'. For cases where a port is set, the DNS record type must be 'a'. If the DNS record type is 'a' and a port is not specified, 5060 will be used.
    - `created_at` string — ISO 8601 formatted date indicating when the resource was created.
    - `updated_at` string — ISO 8601 formatted date indicating when the resource was updated.

## Other responses

- `401` — Unauthorized
- `403` — The user doesn't have the required permissions to perform the requested action.
- `422` — The request was well-formed but was unable to be followed due to semantic errors.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)