Passer au contenu principal
POST
/
cms
/
url-redirects
/
2026-03
Créer une redirection
curl --request POST \
  --url https://api.hubapi.com/cms/url-redirects/2026-03 \
  --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
}
'
{
  "created": "2023-11-07T05:31:56Z",
  "destination": "<string>",
  "id": "<string>",
  "isMatchFullUrl": true,
  "isMatchQueryString": true,
  "isOnlyAfterNotFound": true,
  "isPattern": true,
  "isProtocolAgnostic": true,
  "isTrailingSlashOptional": true,
  "precedence": 123,
  "redirectStyle": 123,
  "routePrefix": "<string>",
  "updated": "2023-11-07T05:31:56Z"
}

Supported products

Autorisations

Authorization
string
header
requis

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

Corps

application/json
destination
string
requis

L'URL de destination, où l'URL cible doit être redirigée si elle correspond au « routePrefix ».

redirectStyle
integer<int32>
requis

Le type de redirection à créer. Les options incluent : 301 (permanent), 302 (temporaire) ou 305 (proxy). Trouvez plus de détails [ici] (https://knowledge.hubspot.com/cos-general/how-to-redirect-a-hubspot-page).

routePrefix
string
requis

L'URL, le chemin ou le motif d'entrée cible à faire correspondre pour la redirection.

isMatchFullUrl
boolean

Si « routePrefix » doit correspondre à l'URL entière, y compris le domaine.

isMatchQueryString
boolean

Si « routePrefix » doit correspondre au chemin complet de l'URL, y compris la chaîne de requête.

isOnlyAfterNotFound
boolean

Si la redirection d'URL doit s'appliquer seulement si une page en ligne à l'URL n'est pas trouvée. Si Faux, la redirection d'URL aura la priorité sur toute page existante.

isPattern
boolean

Si « routePrefix » doit correspondre en fonction du modèle.

isProtocolAgnostic
boolean

Si « routePrefix » doit correspondre aux protocoles HTTP et HTTPS.

isTrailingSlashOptional
boolean

Si une barre oblique sera ignorée.

precedence
integer<int32>

Utilisé pour prioriser la redirection d'URL. Si une URL donnée correspond à plus d'une redirection, celle avec la priorité la plus basse sera utilisée.

Réponse

successful operation

created
string<date-time>
requis

Date et heure auxquelles le mappage d'URL a été initialement créé.

destination
string
requis

L'URL de destination, où l'URL cible doit être redirigée si elle correspond au « routePrefix ».

id
string
requis

L'identifiant unique de cette redirection d'URL.

isMatchFullUrl
boolean
requis

Si « routePrefix » doit correspondre à l'URL entière, y compris le domaine.

isMatchQueryString
boolean
requis

Si « routePrefix » doit correspondre au chemin complet de l'URL, y compris la chaîne de requête.

isOnlyAfterNotFound
boolean
requis

Si la redirection d'URL doit s'appliquer seulement si une page en ligne à l'URL n'est pas trouvée. Si Faux, la redirection d'URL aura la priorité sur toute page existante.

isPattern
boolean
requis

Si « routePrefix » doit correspondre en fonction du modèle.

isProtocolAgnostic
boolean
requis

Si « routePrefix » doit correspondre aux protocoles HTTP et HTTPS.

isTrailingSlashOptional
boolean
requis

Si une barre oblique sera ignorée.

precedence
integer<int32>
requis

Utilisé pour prioriser la redirection d'URL. Si une URL donnée correspond à plus d'une redirection, celle avec la priorité la plus basse sera utilisée.

redirectStyle
integer<int32>
requis

Le type de redirection à créer. Les options incluent : 301 (permanent), 302 (temporaire) ou 305 (proxy). Trouvez plus de détails [ici] (https://knowledge.hubspot.com/cos-general/how-to-redirect-a-hubspot-page).

routePrefix
string
requis

L'URL, le chemin ou le motif d'entrée cible à faire correspondre pour la redirection.

updated
string<date-time>
requis

Date et heure de la dernière modification du mappage d'URL.

Last modified on April 13, 2026