Skip to content

HubSpot: Url mappings schemas

2 HubSpot schemas with complete fields and constraints.

← Url mappings operations · All schemas

Create URL mapping — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
cdnPurgeEmbargoTimeintegerRequired within parentA Unix timestamp in milliseconds indicating the embargo time for CDN purge related to the URL mapping.
Format: int64
contentGroupIdintegerRequired within parentA 64-bit integer representing the content group associated with the URL mapping.
Format: int64
cosObjectTypestringRequired within parentA string representing the type of content object associated with the URL mapping. Valid values include various content types such as 'CONTENT', 'LAYOUT', 'FILE', etc.
One of: 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, GLOBAL_STYLES_THEME, 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
createdintegerRequired within parentA Unix timestamp in milliseconds indicating when the URL mapping was created.
Format: int64
createdByIdintegerRequired within parentThe identifier of the user who created the URL mapping.
Format: int32
deletedAtintegerRequired within parentA Unix timestamp in milliseconds indicating when the URL mapping was deleted.
Format: int64
destinationstringRequired within parentThe destination URL to which the routePrefix is redirected.
idintegerRequired within parentThe unique identifier for the URL mapping, represented as a 64-bit integer.
Format: int64
internallyCreatedbooleanRequired within parentA boolean indicating if the URL mapping was created internally by the system.
isActivebooleanRequired within parentA boolean indicating if the URL mapping is currently active.
isMatchFullUrlbooleanRequired within parentA boolean indicating if the full URL should be matched.
isMatchQueryStringbooleanRequired within parentA boolean indicating if the query string should be matched.
isOnlyAfterNotFoundbooleanRequired within parentA boolean indicating if the mapping should only be applied after a 404 Not Found response.
isPatternbooleanRequired within parentA boolean indicating if the routePrefix is a pattern.
isProtocolAgnosticbooleanRequired within parentA boolean indicating if the mapping should ignore the URL protocol (http/https).
isRegexbooleanRequired within parentA boolean indicating if the routePrefix should be treated as a regular expression.
isTrailingSlashOptionalbooleanRequired within parentA boolean indicating if the trailing slash in the URL is optional.
labelstringRequired within parentA label for the URL mapping.
lastUsedAtintegerRequired within parentA Unix timestamp in milliseconds indicating the last time the URL mapping was used.
Format: int64
namestringRequired within parentThe name of the URL mapping.
notestringRequired within parentA string containing notes about the URL mapping.
portalIdintegerRequired within parentThe identifier for the HubSpot portal associated with this URL mapping.
Format: int32
precedenceintegerRequired within parentAn integer representing the precedence of the URL mapping, used to determine order of evaluation.
Format: int32
redirectStyleintegerRequired within parentAn integer representing the style of redirection used.
Format: int32
routePrefixstringRequired within parentThe prefix of the URL path that is being mapped.
updatedintegerRequired within parentA Unix timestamp in milliseconds indicating when the URL mapping was last updated.
Format: int64
updatedByIdintegerRequired within parentThe identifier of the user who last updated the URL mapping.
Format: int32

Retrieve URL mapping — response body

FieldTypePresenceDescription and constraints
$objectRoot
cdnPurgeEmbargoTimeJSONRequired within parent
cdnPurgeEmbargoTime (anyOf 1)integerAlternativeA Unix timestamp in milliseconds indicating the embargo time for CDN purge related to the URL mapping.
Format: int64
cdnPurgeEmbargoTime (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
contentGroupIdJSONRequired within parent
contentGroupId (anyOf 1)integerAlternativeA 64-bit integer representing the content group associated with the URL mapping.
Format: int64
contentGroupId (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
cosObjectTypestringRequired within parentA string representing the type of content object associated with the URL mapping. Valid values include various content types such as 'CONTENT', 'LAYOUT', 'FILE', etc.
Known values: 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, GLOBAL_STYLES_THEME, 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
createdJSONRequired within parent
created (anyOf 1)integerAlternativeA Unix timestamp in milliseconds indicating when the URL mapping was created.
Format: int64
created (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
createdByIdJSONRequired within parent
createdById (anyOf 1)integerAlternativeThe identifier of the user who created the URL mapping.
Format: int32
createdById (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
deletedAtJSONRequired within parent
deletedAt (anyOf 1)integerAlternativeA Unix timestamp in milliseconds indicating when the URL mapping was deleted.
Format: int64
deletedAt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
destinationstringRequired within parentThe destination URL to which the routePrefix is redirected.
idJSONRequired within parent
id (anyOf 1)integerAlternativeThe unique identifier for the URL mapping, represented as a 64-bit integer.
Format: int64
id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
internallyCreatedbooleanRequired within parentA boolean indicating if the URL mapping was created internally by the system.
isActivebooleanRequired within parentA boolean indicating if the URL mapping is currently active.
isMatchFullUrlbooleanRequired within parentA boolean indicating if the full URL should be matched.
isMatchQueryStringbooleanRequired within parentA boolean indicating if the query string should be matched.
isOnlyAfterNotFoundbooleanRequired within parentA boolean indicating if the mapping should only be applied after a 404 Not Found response.
isPatternbooleanRequired within parentA boolean indicating if the routePrefix is a pattern.
isProtocolAgnosticbooleanRequired within parentA boolean indicating if the mapping should ignore the URL protocol (http/https).
isRegexbooleanRequired within parentA boolean indicating if the routePrefix should be treated as a regular expression.
isTrailingSlashOptionalbooleanRequired within parentA boolean indicating if the trailing slash in the URL is optional.
labelstringRequired within parentA label for the URL mapping.
lastUsedAtJSONRequired within parent
lastUsedAt (anyOf 1)integerAlternativeA Unix timestamp in milliseconds indicating the last time the URL mapping was used.
Format: int64
lastUsedAt (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
namestringRequired within parentThe name of the URL mapping.
notestringRequired within parentA string containing notes about the URL mapping.
portalIdJSONRequired within parent
portalId (anyOf 1)integerAlternativeThe identifier for the HubSpot portal associated with this URL mapping.
Format: int32
portalId (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
precedenceJSONRequired within parent
precedence (anyOf 1)integerAlternativeAn integer representing the precedence of the URL mapping, used to determine order of evaluation.
Format: int32
precedence (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
redirectStyleJSONRequired within parent
redirectStyle (anyOf 1)integerAlternativeAn integer representing the style of redirection used.
Format: int32
redirectStyle (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
routePrefixstringRequired within parentThe prefix of the URL path that is being mapped.
updatedJSONRequired within parent
updated (anyOf 1)integerAlternativeA Unix timestamp in milliseconds indicating when the URL mapping was last updated.
Format: int64
updated (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
updatedByIdJSONRequired within parent
updatedById (anyOf 1)integerAlternativeThe identifier of the user who last updated the URL mapping.
Format: int32
updatedById (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.