Zum Hauptinhalt springen
POST
/
url-mappings
/
2026-03
/
url-mappings
URL-Zuordnung erstellen
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,
  "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.de/docs/llms.txt

Use this file to discover all available pages before exploring further.

Supported products

Autorisierungen

Authorization
string
header
erforderlich

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

Body

*/*
cdnPurgeEmbargoTime
integer<int64>
erforderlich

Ein Unix-Zeitstempel in Millisekunden, der die Embargozeit für die CDN-Bereinigung im Zusammenhang mit der URL-Zuordnung angibt.

contentGroupId
integer<int64>
erforderlich

Eine 64-Bit-Ganzzahl, die die mit der URL-Zuordnung verknüpfte Content-Gruppe darstellt.

cosObjectType
enum<string>
erforderlich

Eine Zeichenfolge, die den Typ des Content-Objekts darstellt, das der URL-Zuordnung zugeordnet ist. Gültige Werte sind Content-Typen wie „CONTENT“, „LAYOUT“, „FILE“ usw.

Verfügbare Optionen:
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
created
integer<int64>
erforderlich

Ein Unix-Zeitstempel in Millisekunden, der angibt, wann die URL-Zuordnung erstellt wurde.

createdById
integer<int32>
erforderlich

Die ID des Benutzers, der die URL-Zuordnung erstellt hat.

deletedAt
integer<int64>
erforderlich

Ein Unix-Zeitstempel in Millisekunden, der angibt, wann die URL-Zuordnung gelöscht wurde.

destination
string
erforderlich

Die Ziel-URL, zu der das routePrefix umgeleitet wird.

id
integer<int64>
erforderlich

Die eindeutige ID für die URL-Zuordnung, dargestellt als 64-Bit-Ganzzahl.

internallyCreated
boolean
erforderlich

Ein boolescher Wert, der angibt, ob die URL-Zuordnung intern vom System erstellt wurde.

isActive
boolean
erforderlich

Ein boolescher Wert, der angibt, ob die URL-Zuordnung derzeit aktiv ist.

isMatchFullUrl
boolean
erforderlich

Ein boolescher Wert, der angibt, ob die vollständige URL abgeglichen werden soll.

isMatchQueryString
boolean
erforderlich

Ein boolescher Wert, der angibt, ob die Abfragezeichenfolge abgeglichen werden soll.

isOnlyAfterNotFound
boolean
erforderlich

Ein boolescher Wert, der angibt, ob die Zuordnung nur nach einer „404 Nicht gefunden“-Antwort angewendet werden soll.

isPattern
boolean
erforderlich

Ein boolescher Wert, der angibt, ob das routePrefix ein Muster ist.

isProtocolAgnostic
boolean
erforderlich

Ein boolescher Wert, der angibt, ob die Zuordnung das URL-Protokoll (http/https) ignorieren soll.

isRegex
boolean
erforderlich

Ein boolescher Wert, der angibt, ob das routePrefix als regulärer Ausdruck behandelt werden soll.

isTrailingSlashOptional
boolean
erforderlich

Ein boolescher Wert, der angibt, ob der abschließende Schrägstrich in der URL optional ist.

label
string
erforderlich

Ein Label für die URL-Zuordnung.

lastUsedAt
integer<int64>
erforderlich
name
string
erforderlich

Der Name der URL-Zuordnung.

note
string
erforderlich

Eine Zeichenfolge mit Notizen zur URL-Zuordnung.

portalId
integer<int32>
erforderlich

Die ID für das HubSpot-Portal, das dieser URL-Zuordnung zugeordnet ist.

precedence
integer<int32>
erforderlich

Eine Ganzzahl, die die Priorität der URL-Zuordnung darstellt und zur Bestimmung der Auswertungsreihenfolge verwendet wird.

redirectStyle
integer<int32>
erforderlich

Eine Ganzzahl, die den verwendeten Weiterleitungsstil angibt.

routePrefix
string
erforderlich

Das Präfix des URL-Pfads, der zugeordnet wird.

updated
integer<int64>
erforderlich

Ein Unix-Zeitstempel in Millisekunden, der angibt, wann die URL-Zuordnung zuletzt aktualisiert wurde.

updatedById
integer<int32>
erforderlich

Die ID des Benutzers, der die URL-Zuordnung zuletzt aktualisiert hat.

Antwort

default - */*
category
string
erforderlich

Die Fehlerkategorie

correlationId
string<uuid>
erforderlich

Eine eindeutige ID für die Anfrage. Beziehen Sie diesen Wert in Fehlerberichte oder Support-Tickets ein

Beispiel:

"aeb5f871-7f07-4993-9211-075dc63e7cbf"

message
string
erforderlich

Eine für Menschen lesbare Nachricht mit einer Beschreibung des Fehlers und ggf. Abhilfemaßnahmen

Beispiel:

"An error occurred"

context
object

Kontext zur Fehlerbedingung

Beispiel:

"{invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]}"

errors
object[]

Weitere Informationen über den Fehler

Eine Zuordnung der Namen von Links zu zugehörigen URIs mit einer Dokumentation zum Fehler oder empfohlenen Abhilfemaßnahmen

subCategory
string

Eine spezifische Kategorie, die genauere Details über den Fehler enthält

Last modified on April 13, 2026