---
title: "POST /cms/url-redirects/2026-03/url-mappings"
method: POST
path: "/cms/url-redirects/2026-03/url-mappings"
tags: ["Basic"]
---

# POST /cms/url-redirects/2026-03/url-mappings

`POST /cms/url-redirects/2026-03/url-mappings`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/cms/url-redirects/2026-03/url-mappings`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `hapikey`
  - none

## Request body `*/*`

- CmsUrlRedirectsUrlMapping
  - `created` string, date-time, required: The date and time when the URL mapping was initially created.
  - `destination` string, required: The destination URL, where the target URL should be redirected if it matches the `routePrefix`.
  - `id` string, required: The unique ID of this URL redirect.
  - `isMatchFullUrl` boolean, required: Whether the `routePrefix` should match on the entire URL, including the domain.
  - `isMatchQueryString` boolean, required: Whether the `routePrefix` should match on the entire URL path, including the query string.
  - `isOnlyAfterNotFound` boolean, required: Whether the URL redirect mapping should apply only if a live page on the URL isn't found. If False, the URL redirect mapping will take precedence over any existing page.
  - `isPattern` boolean, required: Whether the `routePrefix` should match based on pattern.
  - `isProtocolAgnostic` boolean, required: Whether the `routePrefix` should match both HTTP and HTTPS protocols.
  - `isTrailingSlashOptional` boolean, required: Whether a trailing slash will be ignored.
  - `precedence` integer, required: Used to prioritize URL redirection. If a given URL matches more than one redirect, the one with the **lower** precedence will be used.
  - `redirectStyle` integer, required: The type of redirect to create. Options include: 301 (permanent), 302 (temporary), or 305 (proxy). Find more details [here](https://knowledge.hubspot.com/cos-general/how-to-redirect-a-hubspot-page).
  - `routePrefix` string, required: The target incoming URL, path, or pattern to match for redirection.
  - `updated` string, date-time, required: The date and time when the URL mapping was last modified.

## Response `default`

An error occurred.

- Error
  - `category` string, required: The error category
  - `context` object: Context about the error condition
  - `correlationId` string, uuid, required: A unique identifier for the request. Include this value with any error reports or support tickets
  - `errors` ErrorDetail[]: further information about the error
    - `code` string: The status code associated with the error detail
    - `context` object: Context about the error condition
    - `in` string: The name of the field or parameter in which the error was found.
    - `message` string, required: A human readable message describing the error along with remediation steps where appropriate
    - `subCategory` string: A specific category that contains more specific detail about the error
  - `links` object: A map of link names to associated URIs containing documentation about the error or recommended remediation steps
  - `message` string, required: A human readable message describing the error along with remediation steps where appropriate
  - `subCategory` string: A specific category that contains more specific detail about the error

## Changes

> 14 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-05-27** `f9c7181056c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/hubspot-api-specification/changes/cms/url-redirects/2026-03/url-mappings/post.md)

---

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