Saltar al contenido principal
POST
/
cms
/
v3
/
url-redirects
Crea un redireccionamiento
curl --request POST \
  --url https://api.hubapi.com/cms/v3/url-redirects/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "destination": "<string>",
  "redirectStyle": 123,
  "routePrefix": "<string>",
  "isMatchFullUrl": true,
  "isMatchQueryString": true,
  "isOnlyAfterNotFound": true,
  "isPattern": true,
  "isProtocolAgnostic": true,
  "isTrailingSlashOptional": true,
  "precedence": 123
}
'
{
  "destination": "<string>",
  "id": "<string>",
  "isMatchFullUrl": true,
  "isMatchQueryString": true,
  "isOnlyAfterNotFound": true,
  "isPattern": true,
  "isProtocolAgnostic": true,
  "isTrailingSlashOptional": true,
  "precedence": 123,
  "redirectStyle": 123,
  "routePrefix": "<string>",
  "created": "2023-11-07T05:31:56Z",
  "updated": "2023-11-07T05:31:56Z"
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Pro
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Starter

Autorizaciones

Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Cuerpo

application/json
destination
string
requerido

La URL de destino, a la que debe redirigirse la URL objetivo si coincide con el routePrefix.

redirectStyle
integer<int32>
requerido

El tipo de redireccionamiento que se creará. Las opciones incluyen: 301 (permanente), 302 (temporal) o 305 (proxy). Encuentra más detalles aquí.

routePrefix
string
requerido

La URL entrante de destino, la ruta o el patrón que debe coincidir para el redireccionamiento.

isMatchFullUrl
boolean

Si el routePrefix debe coincidir con la URL completa, incluido el dominio.

isMatchQueryString
boolean

Si el routePrefix debe coincidir con la ruta completa de la URL, incluida la cadena de consulta.

isOnlyAfterNotFound
boolean

Si el mapeo de redireccionamiento de URL debe aplicarse solo si no se encuentra una página activa en la URL. Si es False, el mapeo de redireccionamiento de URL tendrá prioridad sobre cualquier página existente.

isPattern
boolean

Si el routePrefix debe coincidir en función del patrón.

isProtocolAgnostic
boolean

Si el routePrefix debe coincidir con ambos protocolos HTTP y HTTPS.

isTrailingSlashOptional
boolean

Si se ignorará una barra diagonal final.

precedence
integer<int32>

Se utiliza para priorizar el redireccionamiento de URL. Si una URL dada coincide con más de un redireccionamiento, se utilizará el de menor precedencia.

Respuesta

successful operation

destination
string
requerido

La URL de destino, a la que debe redirigirse la URL objetivo si coincide con el routePrefix.

id
string
requerido

El ID único de este redireccionamiento de URL.

isMatchFullUrl
boolean
requerido

Si el routePrefix debe coincidir con la URL completa, incluido el dominio.

isMatchQueryString
boolean
requerido

Si el routePrefix debe coincidir con la ruta completa de la URL, incluida la cadena de consulta.

isOnlyAfterNotFound
boolean
requerido

Si el mapeo de redireccionamiento de URL debe aplicarse solo si no se encuentra una página activa en la URL. Si es False, el mapeo de redireccionamiento de URL tendrá prioridad sobre cualquier página existente.

isPattern
boolean
requerido

Si el routePrefix debe coincidir en función del patrón.

isProtocolAgnostic
boolean
requerido

Si el routePrefix debe coincidir con ambos protocolos HTTP y HTTPS.

isTrailingSlashOptional
boolean
requerido

Si se ignorará una barra diagonal final.

precedence
integer<int32>
requerido

Se utiliza para priorizar el redireccionamiento de URL. Si una URL dada coincide con más de un redireccionamiento, se utilizará el de menor precedencia.

redirectStyle
integer<int32>
requerido

El tipo de redireccionamiento que se creará. Las opciones incluyen: 301 (permanente), 302 (temporal) o 305 (proxy). Encuentra más detalles aquí.

routePrefix
string
requerido

La URL entrante de destino, la ruta o el patrón que debe coincidir para el redireccionamiento.

created
string<date-time>

La fecha y hora en que se creó inicialmente la asignación de URL.

updated
string<date-time>

La fecha y hora en que se modificó por última vez la asignación de URL.

Last modified on March 30, 2026