---
title: "Create a new forwarding configuration for the given FQDN"
method: POST
path: "/v2/customers/{customerId}/domains/forwards/{fqdn}"
tags: ["Domains"]
---

# Create a new forwarding configuration for the given FQDN

`POST /v2/customers/{customerId}/domains/forwards/{fqdn}`

<strong>Notes:</strong><ul><li>**shopperId** is **not the same** as **customerId**.  **shopperId** is a number of max length 10 digits (*ex:* 1234567890) whereas **customerId** is a UUIDv4 (*ex:* 295e3bc3-b3b9-4d95-aae5-ede41a994d13)</li></ul>

## Path parameters

- `customerId` string, required
- `fqdn` string, required

## Request body

- DomainForwardingCreate
  - `type` 'MASKED' | 'REDIRECT_PERMANENT' | 'REDIRECT_TEMPORARY', required — The type of fowarding to implement<br/><ul><li><strong style='margin-left: 12px;'>MASKED</strong> - Prevents the forwarded domain or subdomain URL from displaying in the browser's address bar.</li><li><strong style='margin-left: 12px;'>REDIRECT_PERMANENT*</strong> - Redirects to the url you specified in the forwardTo field using a `301 Moved Permanently` HTTP response. The HTTP 301 response code tells user-agents (including search engines) that the location has permanently moved.</li><li><strong style='margin-left: 12px;'>REDIRECT_TEMPORARY</strong> - Redirects to the url you specified in the forwardTo field using a `302 Found` HTTP response. The HTTP 302 response code tells user-agents (including search engines) that the location has temporarily moved.</li></ul>
  - `url` string, url, required — Forwards http(s) traffic to this destination url (ex. http://www.somedomain.com/)
  - `mask` DomainForwardingMask
    - `title` string — Displays at the top of the browser window and in search results.
    - `description` string — A short description of your website to display in search engine results.
    - `keywords` string — A list of comma-separated keywords that describes the content and purpose of your website.

## Response `204`

Request was successful

## Other responses

- `401` — Authentication info not sent or invalid
- `403` — Authenticated user is not allowed access
- `404` — Resource not found
- `409` — Provided `fqdn` already has forwarding setup
- `422` — Request body doesn't fulfill schema, see details in `fields`
- `429` — Too many requests received within interval
- `500` — Internal server error

---

[API](https://skmtc.net/godaddy/apis/domains-api.md) · [All operations](https://skmtc.net/godaddy/apis/domains-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/godaddy/domains-api/versions/475bd0561c3c/schema)