---
title: "One-click DNS setup link"
method: GET
path: "/v1/domains/{id}/setup-link"
tags: ["Domains"]
---

# One-click DNS setup link

`GET /v1/domains/{id}/setup-link`

## Request

- Base URL: `https://api.volanea.com`
- URL: `https://api.volanea.com/v1/domains/{id}/setup-link`
- Auth: HTTP bearer

A Domain Connect link: the domain owner opens it, approves at their DNS provider, and the records are written for them. When the provider doesn't support it (or it isn't configured here), `supported` is false and `records` are the ones to add by hand. `service=inbound` gives the MX record for an inbox subdomain.

## Path parameters

- `id` string, required

## Query parameters

- `service` 'sending' | 'inbound'
- `redirectUri` string, uri

## Response `200`

Link, or manual records.

- object
  - `supported` boolean, required
  - `url` string, uri
  - `provider` string
  - `reason` string
  - `records` object[], required

## Other responses

- `401`: Missing or invalid API key.
- `404`: Not found.
- `422`: Request validation failed (code `validation_error`, 422).

---

[API](https://skmtc.dev/volanea/apis/volanea-api.md) · [All operations](https://skmtc.dev/volanea/apis/volanea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volanea/apis/volanea-api/revisions/9e187ae84fda?raw)