---
title: "Set up a link domain's DNS in one click"
method: POST
path: "/v1/link-domains/{id}/domain-connect"
tags: ["Domains"]
---

# Set up a link domain's DNS in one click

`POST /v1/link-domains/{id}/domain-connect`

## Request

- Base URL: `https://smtpfa.st/api`
- URL: `https://smtpfa.st/api/v1/link-domains/{id}/domain-connect`
- Auth: HTTP bearer

Returns a signed Domain Connect link. The domain owner opens it, approves the CNAME record at the DNS provider, and the link domain turns active once Cloudflare sees the record. 409 with the reason when the provider cannot apply it, or the link domain is not pending (refresh a failed one first). Not in Resend. Requires the domain:write scope; 30 per 10 minutes per team.

## Path parameters

- `id` string, required

## Response `200`

The link to open

- LinkDomainConnectLink
  - `url` string, required: The signed link to open. The DNS provider shows the CNAME record and asks the domain owner to approve it.
  - `provider` string, required

## Other responses

- `401`: Invalid or missing API key
- `403`: Forbidden - domain not verified or insufficient permissions
- `404`: Resource not found
- `409`: Conflict - the resource already exists or changed meanwhile
- `429`: Rate limit exceeded - retry after the period indicated in the Retry-After header
- `500`: Internal server error

---

[API](https://skmtc.dev/smtpfa/apis/smtpfast-api.md) · [All operations](https://skmtc.dev/smtpfa/apis/smtpfast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smtpfa/apis/smtpfast-api/revisions/79dda742f53e?raw)