Zugriffstoken aktualisieren

curl --request POST \
  --url https://api.hubapi.com/oauth/v1/token \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'client_id=<string>' \
  --data 'client_secret=<string>' \
  --data 'code=<string>' \
  --data 'code_verifier=<string>' \
  --data grant_type=authorization_code \
  --data 'redirect_uri=<string>' \
  --data 'refresh_token=<string>' \
  --data 'scope=<string>'

{
  "accessToken": "<string>",
  "expiresIn": 123,
  "hubId": 123,
  "idToken": "<string>",
  "scopes": [
    "<string>"
  ],
  "tokenType": "<string>",
  "userId": 123
}

Token

Refresh an access token

Verwenden Sie ein zuvor abgerufenes Aktualisierungstoken, um ein neues Zugriffstoken zu generieren.

Zugriffstoken sind kurzlebig. Sie können den Parameter „expires_in“ beim Generieren eines Zugriffstokens überprüfen, um seine Lebensdauer (in Sekunden) zu bestimmen. Wenn Sie Offline-Zugriff auf HubSpot-Daten benötigen, speichern Sie das Aktualisierungstoken, das Sie bei der Initiierung Ihrer OAuth-Integration erhalten, und verwenden Sie es, um ein neues Zugangstoken zu generieren, wenn das erste abgelaufen ist.

Hinweis: Die Größe von HubSpot-Zugriffstoken schwankt, da sich die darin codierten Informationen im Laufe der Zeit ändern. Es wird empfohlen, für Token bis zu 300 Zeichen zuzulassen, damit mögliche Änderungen berücksichtigt werden können.

POST

oauth

token

Zugriffstoken aktualisieren

curl --request POST \
  --url https://api.hubapi.com/oauth/v1/token \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'client_id=<string>' \
  --data 'client_secret=<string>' \
  --data 'code=<string>' \
  --data 'code_verifier=<string>' \
  --data grant_type=authorization_code \
  --data 'redirect_uri=<string>' \
  --data 'refresh_token=<string>' \
  --data 'scope=<string>'

{
  "accessToken": "<string>",
  "expiresIn": 123,
  "hubId": 123,
  "idToken": "<string>",
  "scopes": [
    "<string>"
  ],
  "tokenType": "<string>",
  "userId": 123
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.

Marketing Hub -Kostenlos

Sales Hub -Kostenlos

Service Hub -Kostenlos

Content Hub -Kostenlos

Abfrageparameter

client_secret

string

Eine vertrauliche Anmeldeinformation, die nur der Anwendung und dem Autorisierungsserver bekannt ist und zur Authentifizierung der Identität des Clients beim Anfragen von Token verwendet wird.

refresh_token

string

Eine langfristige Berechtigung, die zusammen mit einem Zugriffstoken ausgestellt wird und bei Ablauf des aktuellen Zugriffstokens zusammen mit den Client-Anmeldedaten gegen ein neues Zugriffstoken eingetauscht werden kann, sodass der API-Zugriff ohne erneutes Authentifizieren des Benutzers fortgesetzt werden kann.

Body

application/x-www-form-urlencoded

client_id

string

client_secret

string

code

string

code_verifier

string

grant_type

enum<string>

Verfügbare Optionen:

authorization_code,

client_credentials,

refresh_token

redirect_uri

string

refresh_token

string

scope

string

Antwort

successful operation

accessToken

string

Der Zugriffstoken, der für die Authentifizierung in API-Anfragen verwendet wird.

expiresIn

integer<int64>

Die Dauer in Sekunden, für die das Zugriffstoken gültig ist.

hubId

integer<int32>

Die ID des HubSpot-Accounts, der dem Token zugeordnet ist.

idToken

string

Das ID-Token, das Identitätsangaben zum Benutzer enthält.

scopes

string[]

tokenType

string

Der Typ des Tokens, der in der Regel das Authentifizierungsschema angibt. In der Regel „bearer“.

userId

integer<int32>

Die ID des HubSpot-Benutzers, für den das Token erstellt wurde.

Last modified on December 12, 2025

OAuth-Zugriffstoken verwalten

Zurück

Retrieve OAuth token metadata

Weiter

⌘I