Account & Settings
Gestión de aplicaciones
Autenticación
Automatización
Communication preferences
Conversaciones
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
Crea una nueva asignación de URL en tu cuenta de HubSpot. Este punto de terminación te permite definir redireccionamientos y asignaciones de URL, lo que puede ser útil para gestionar la navegación del sitio y el SEO. El cuerpo de la solicitud debe incluir todas las propiedades requeridas del esquema 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"
}
}Documentation Index
Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt
Use this file to discover all available pages before exploring further.
Supported products
Supported products
Required Scopes
Required Scopes
Autorizaciones
The access token received from the authorization server in the OAuth 2.0 flow.
Cuerpo
Una marca de tiempo Unix en milisegundos que indica el tiempo de embargo para la purga de CDN relacionada con la asignación de URL.
Un número entero de 64 bits que representa el grupo de contenido asociado con la asignación de URL.
Una cadena que representa el tipo de objeto de contenido asociado a la asignación de URL. Los valores válidos incluyen varios tipos de contenido, como "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 Una marca de tiempo Unix en milisegundos que indica cuándo se creó la asignación de URL.
El identificador del usuario que creó la asignación de URL.
Una marca de tiempo Unix en milisegundos que indica cuándo se eliminó la asignación de URL.
La URL de destino a la que se hace el redireccionamiento del routePrefix.
El identificador único para la asignación de URL, representado como un número entero de 64 bits.
Un booleano que indica si la asignación de URL fue creada internamente por el sistema.
Un booleano que indica si la asignación de URL está activa actualmente.
Un boolean que indica si la URL completa debe coincidir.
Un boolean que indica si la cadena de consulta debe coincidir.
Un booleano que indica si la asignación solo se debe aplicar después de una respuesta 404 No encontrado.
Un booleano que indica si el routePrefix es un patrón.
Un booleano que indica si la asignación debe ignorar el protocolo de URL (http/https).
Un booleano que indica si routePrefix debe tratarse como una expresión regular.
Un booleano que indica si la barra final en la URL es opcional.
Una etiqueta para la asignación de URL.
El nombre de la asignación de URL.
Una cadena con notas sobre la asignación de URL.
El identificador del portal de HubSpot asociado a esta asignación de URL.
Un número entero que representa la precedencia de la asignación de URL, usado para determinar el orden de evaluación.
Un número entero que representa el estilo de redireccionamiento utilizado.
El prefijo de la ruta de URL que se está asignando.
Una marca de tiempo Unix en milisegundos que indica cuándo se actualizó por última vez la asignación de URL.
El identificador del usuario que actualizó por última vez el mapeo de URL.
Respuesta
La categoría del error
Un identificador único para la solicitud. Incluye este valor con cualquier informe de error o ticket de asistencia.
"aeb5f871-7f07-4993-9211-075dc63e7cbf"
Un mensaje legible en el que se describa el error y los pasos para solucionarlo, si procede
"An error occurred"
Contexto de la condición de error
Show child attributes
Show child attributes
"{invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]}"
información adicional acerca del error
Show child attributes
Show child attributes
Un mapa de nombres de enlaces a las URI asociadas que contienen documentación sobre el error o los pasos recomendados para solucionarlo
Show child attributes
Show child attributes
Una categoría específica que contiene detalles más concretos acerca del error