---
title: "Create a Dynamic DNS entry"
method: POST
path: "/dynamic-dns/entries"
tags: ["Dynamic DNS"]
---

# Create a Dynamic DNS entry

`POST /dynamic-dns/entries`

Create and validate a Dynamic DNS entry

## Request body

- GithubComAlchemillahqSylveInternalServicesDynamicdnsEntryInput
  - `enabled` boolean
  - `hostname` string
  - `intervalMinutes` integer
  - `provider` string
  - `providerSettings` object
  - `recordType` string
  - `sourceSettings` object
  - `sourceType` string
  - `token` string

## Response `201`

Created

- GithubComAlchemillahqSylveInternalAPIResponseGithubComAlchemillahqSylveInternalServicesDynamicdnsEntryView
  - `data` GithubComAlchemillahqSylveInternalServicesDynamicdnsEntryView
    - `consecutiveFailures` integer
    - `createdAt` string
    - `credentialConfigured` boolean
    - `enabled` boolean
    - `hostname` string
    - `id` integer
    - `intervalMinutes` integer
    - `ipv4Error` string
    - `ipv4Status` string
    - `ipv6Error` string
    - `ipv6Status` string
    - `lastError` string
    - `lastIPv4` string
    - `lastIPv6` string
    - `lastStatus` string
    - `lastSuccessAt` string
    - `lastSyncAt` string
    - `nextRetryAt` string
    - `provider` string
    - `providerSettings` object
    - `recordType` string
    - `sourceSettings` object
    - `sourceType` string
    - `updatedAt` string
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request
- `409` — Conflict
- `413` — Payload Too Large
- `500` — Internal Server Error
- `502` — Bad Gateway

---

[API](https://skmtc.net/alchemillahq/apis/sylve-api.md) · [All operations](https://skmtc.net/alchemillahq/apis/sylve-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alchemillahq/sylve-api/revisions/7a7bea85004e/schema)