Add an own domain

Adds a domain for the account's links. Then add a CNAME record from the hostname to customers.snip.link at your DNS provider; the domain turns active within minutes of the record resolving, certificate included, and links made with "domain": "go.example.com" on create_link answer at https://go.example.com/<ending>. Endings are per domain, so go.example.com/menu and snip.link/menu are different links. Pro holds 5; other plans answer 403 forbidden with details.upgrade.

Request body

JSON, sent with Content-Type: application/json.

Example request

curl -s -X POST "https://snip.link/v1/domains" \
  -H "Authorization: Bearer $SNIP_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Example response

{
  "domain": {
    "id": "dom_3c1f0a9e2b7d4c55",
    "hostname": "go.example.com",
    "status": "active",
    "detail": null,
    "cname_target": "customers.snip.link",
    "root_url": "https://example.com",
    "links": 42,
    "created_at": "2026-10-20T12:00:00.000Z"
  }
}

Response fields

Errors