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"
}
}HubSpotアカウントで新しいURLマッピングを作成します。このエンドポイントを使用すると、URLリダイレクトとマッピングを定義でき、サイトナビゲーションとSEOの管理に役立ちます。リクエスト本文には、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
Required Scopes
The access token received from the authorization server in the OAuth 2.0 flow.
URLマッピングに関連するCDN消去の禁止時間を示すミリ秒単位のUnixタイムスタンプ。
URLマッピングに関連付けられたコンテンツグループを表す64ビットの整数。
URLマッピングに関連付けられているコンテンツオブジェクトのタイプを表す文字列。有効な値には、「CONTENT」、「LAYOUT」、「FILE」などのさまざまなコンテンツタイプが含まれます。
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 URLマッピングが作成された日時を示すミリ秒単位のUnixタイムスタンプ。
URLマッピングを作成したユーザーのID。
URLマッピングが削除された日時を示すミリ秒単位のUnixタイムスタンプ。
routePrefixのリダイレクト先となるURL。
URLマッピングの固有IDで、64ビットの整数として表されます。
URLマッピングがシステムによって内部で作成されたかどうかを示すブール値。
URLマッピングが現在有効であるかどうかを示すブール値。
URLが完全一致する必要があるかどうかを示すブール値。
クエリー文字列が一致する必要があるかどうかを示すブール値。
マッピングを「404 Not Found」レスポンスの後にのみ適用するかどうかを示すブール値。
routePrefixがパターンであるかどうかを示すブール値。
マッピングでURLプロトコル (http/https) を無視するかどうかを示すブール値。
routePrefixを正規表現として扱うかどうかを示すブール値。
URLの末尾のスラッシュが任意であるかどうかを示すブール値。
URLマッピングのラベル。
URLマッピングの名前。
URLマッピングに関するメモが含まれる文字列。
このURLマッピングに関連付けられているHubSpotポータルのID。
URLマッピングの優先順位を表す整数。評価順序の決定に使用されます。
使用されるリダイレクトのスタイルを表す整数。
対応付けられるURLパスの先頭文字列。
URLマッピングが最後に更新された日時を示すミリ秒単位のUnixタイムスタンプ。
URLマッピングを最後に更新したユーザーのID。
エラーカテゴリー
リクエストの固有ID。エラー報告またはサポートチケットには必ずこの値を含めてください
"aeb5f871-7f07-4993-9211-075dc63e7cbf"
エラーと修正手順(該当する場合)を記した、人が理解できるメッセージ
"An error occurred"
エラー条件に関する背景状況
Show child attributes
"{invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]}"
エラーに関する詳細情報
Show child attributes
エラーまたは推奨の修正手順に関するドキュメントが含まれる関連付けられたURIへのリンク名の対応付け
Show child attributes
エラーに関する具体的な詳細が含まれる特定のカテゴリー