Account & Settings
Gestion des applications
Authentification
Automatisation
Communication preferences
Conversations
Événements
Fichiers
Marketing
Scheduler
curl --request POST \
--url https://api.hubapi.com/url-mappings/2026-03/url-mappings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: */*' \
--data '
{
"cdnPurgeEmbargoTime": 123,
"contentGroupId": 123,
"cosObjectType": "ACCESS_GROUP_MEMBERSHIP",
"created": 123,
"createdById": 123,
"deletedAt": 123,
"destination": "<string>",
"id": 123,
"internallyCreated": true,
"isActive": true,
"isMatchFullUrl": true,
"isMatchQueryString": true,
"isOnlyAfterNotFound": true,
"isPattern": true,
"isProtocolAgnostic": true,
"isRegex": true,
"isTrailingSlashOptional": true,
"label": "<string>",
"lastUsedAt": 123,
"name": "<string>",
"note": "<string>",
"portalId": 123,
"precedence": 123,
"redirectStyle": 123,
"routePrefix": "<string>",
"updated": 123,
"updatedById": 123
}
'{
"message": "Invalid input (details will vary based on the error)",
"correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
"category": "VALIDATION_ERROR",
"links": {
"knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
}
}Create a mapping
Créez un nouveau mappage d’URL dans votre compte HubSpot. Ce point de terminaison vous permet de définir des redirections et des mappage d’URL, ce qui peut être utile pour gérer la navigation du site et le référencement. Le corps de la requête doit inclure toutes les propriétés requises du schéma UrlMapping.
curl --request POST \
--url https://api.hubapi.com/url-mappings/2026-03/url-mappings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: */*' \
--data '
{
"cdnPurgeEmbargoTime": 123,
"contentGroupId": 123,
"cosObjectType": "ACCESS_GROUP_MEMBERSHIP",
"created": 123,
"createdById": 123,
"deletedAt": 123,
"destination": "<string>",
"id": 123,
"internallyCreated": true,
"isActive": true,
"isMatchFullUrl": true,
"isMatchQueryString": true,
"isOnlyAfterNotFound": true,
"isPattern": true,
"isProtocolAgnostic": true,
"isRegex": true,
"isTrailingSlashOptional": true,
"label": "<string>",
"lastUsedAt": 123,
"name": "<string>",
"note": "<string>",
"portalId": 123,
"precedence": 123,
"redirectStyle": 123,
"routePrefix": "<string>",
"updated": 123,
"updatedById": 123
}
'{
"message": "Invalid input (details will vary based on the error)",
"correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
"category": "VALIDATION_ERROR",
"links": {
"knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
}
}Supported products
Supported products
Required Scopes
Required Scopes
Autorisations
The access token received from the authorization server in the OAuth 2.0 flow.
Corps
Un horodatage Unix en millisecondes indiquant l'heure d'embargo pour la purge du réseau de diffusion de contenu liée au mappage d'URL.
Un entier 64 bits représentant le groupe de contenu associé au mappage d'URL.
Une chaîne représentant le type d'objet de contenu associé au mappage d'URL. Les valeurs valides incluent divers types de contenu tels que « CONTENT », « LAYOUT », « FILE », etc.
ACCESS_GROUP_MEMBERSHIP, APP_PAGE, BLOCK, BLOG, BLOG_AUTHOR, BRAND_BUSINESS_UNIT, BRAND_SETTINGS, CONTACT_MEMBERSHIP, CONTENT, CONTENT_EMBED, CONTENT_FOLDER, CONTENT_GROUP, CRM_OBJECT, CRM_OBJECT_TYPE, CUSTOM_WIDGET, CUSTOMER_PORTAL, DATA_QUERY, DESIGN_FOLDER, DOMAIN, DOMAIN_SETTINGS, EMAIL_ADDRESS, EXTENSION_RESOURCE, FILE, FOLDER, FOLLOW_ME, FORM, GLOBAL_CONTENT, HUBDB_TABLE, HUBDB_TABLE_ROW, IMAGE, JS_PROJECT_COMPONENT, KNOWLEDGE_BASE, KNOWLEDGE_CATEGORY, KNOWLEDGE_CATEGORY_TRANSLATION, KNOWLEDGE_HOMEPAGE_CATEGORY, LAYOUT, LAYOUT_SECTION, LIST_MEMBERSHIP, MARKETPLACE_LISTING, PASSWORD_PROTECTED, PAYMENT, PERSONALIZATION_TOKEN, PLACEMENT, PROJECT, QUOTE_TEMPLATE, RAW_ASSET, REDIRECT_URL, SECTION, SERVERLESS_FUNCTION, SITE_MAP, SITE_MENU, SITE_SETTINGS, SUBSCRIPTIONS_SETTINGS, TAG, THEME, THEME_SETTINGS, UNRESTRICTED_ACCESS, URL_MAPPING, VIDEO_PLAYER, WIDGET, WORKFLOW Un horodatage Unix en millisecondes indiquant la date de création du mappage d'URL.
L'identifiant de l'utilisateur ou de l'utilisatrice qui a créé le mappage d'URL.
Un horodatage Unix en millisecondes indiquant la date de suppression du mappage d'URL.
L'URL de destination vers laquelle le routePrefix est redirigé.
L'identifiant unique du mappage d'URL, représenté sous la forme d'un entier de 64 bits.
Un booléen indiquant si le mappage d'URL a été créé en interne par le système.
Un booléen indiquant si le mappage d'URL est actuellement actif.
Un booléen indiquant si l'URL complète doit être mise en correspondance.
Une valeur booléenne indiquant si la chaîne de requête doit être mise en correspondance.
Un booléen indiquant si le mappage doit être appliqué uniquement après une réponse 404 introuvable.
Un booléen indiquant si le routePrefix est un modèle.
Un booléen indiquant si le mappage doit ignorer le protocole URL (http/https).
Un booléen indiquant si le routePrefix doit être traité comme une expression régulière.
Un booléen indiquant si la barre oblique finale dans l'URL est facultative.
Un libellé pour le mappage d'URL.
Le nom du mappage d'URL.
Une chaîne contenant des notes sur le mappage d'URL.
L'identifiant du Portail HubSpot associé à ce mappage d'URL.
Un entier représentant la précédence du mappage d'URL, utilisé pour déterminer l'ordre d'évaluation.
Un entier représentant le style de redirection utilisé.
Le préfixe du chemin d'URL qui est mappé.
Un horodatage Unix en millisecondes indiquant la dernière mise à jour du mappage d'URL.
L'identifiant de l'utilisateur ayant mis à jour le mappage d'URL en dernier.
Réponse
La catégorie d'erreur
Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreurs ou tickets d'assistance
"aeb5f871-7f07-4993-9211-075dc63e7cbf"
Un message lisible par l'utilisateur décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant
"An error occurred"
Contexte concernant la condition d'erreur
Show child attributes
Show child attributes
"{invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]}"
informations supplémentaires à propos de l'erreur
Show child attributes
Show child attributes
Une carte des noms de liens vers les URI associés contenant la documentation sur l'erreur ou les mesures correctives recommandées
Show child attributes
Show child attributes
Une catégorie spécifique qui contient des détails plus précis sur l'erreur