---
title: "Set Domain Fallback Routing"
method: POST
path: "/account/domains/{domain_id}/routing/fallback"
tags: ["Account", "Domains"]
---

# Set Domain Fallback Routing

`POST /account/domains/{domain_id}/routing/fallback`

## Request

- Base URL: `https://api.rebrandly.com/v1`
- URL: `https://api.rebrandly.com/v1/account/domains/{domain_id}/routing/fallback`
- Auth: API key in header `apikey`

Configure custom 404/fallback routing for the domain.

**Feature Required:** `domains.whitelabeled.fallback`

## Path parameters

- `domain_id` string, required

## Headers

- `apikey` string, required

## Request body

- object
  - `url` string, uri: Fallback destination URL
  - `policy` 'redirect' | 'frame': Routing policy
  - `targetDomain` string: Target domain for fallback

## Response `200`

Fallback routing configured

- AccountDomain: Domain owned by the account
  - `id` string, required: Domain public ID (32 characters)
  - `fullName` string, required: Full domain name
  - `topLevelDomain` string: Top-level domain
  - `type` 'USER' | 'SYSTEM': Domain type (USER = custom, SYSTEM = rebrandly provided)
  - `ownerId` string: Owner account public ID
  - `provider` string: Domain provider name
  - `level` integer: Domain hierarchy level (1 = root domain)
  - `managed` boolean: Whether domain is managed by Rebrandly
  - `https` boolean: Whether HTTPS is enabled
  - `status` object
    - `dns` 'unverified' | 'verified' | 'verifying': DNS verification status
    - `subscription` 'requested' | 'activating' | 'active' | 'error' | 'revoked' | 'renewing': Domain subscription status
  - `sharing` object
    - `protocol` object
      - `default` 'http' | 'https'
      - `allowed` string[]
  - `routing` object
    - `addressing` 'unicast' | 'anycast'
    - `hostnames` object[]
      - `hostname` string
      - `layer` string
      - `managed` boolean
    - `homepage` object
      - `mode` string
      - `url` string
    - `fallback` object
      - `mode` string
      - `url` string
      - `targetDomain` string
    - `root` string: Root URL for the domain
  - `parent` object: Parent domain (for subdomains)
    - `id` string
    - `fullName` string
    - `managed` boolean
  - `subdomains` integer: Number of subdomains
  - `nameservers` string[]: DNS nameservers
  - `autorenew` boolean: Whether auto-renewal is enabled
  - `expiration` object: Domain expiration information
    - `date` string, date-time
    - `targetDate` string, date-time
  - `price` object: Domain pricing
    - `registration` number
    - `renewal` number
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `403`: Feature not available

---

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