Zum Hauptinhalt springen
POST
/
oauth
/
v3
/
token
OAuth token endpoint
curl --request POST \
  --url https://api.hubapi.com/oauth/v3/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>'
{
  "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

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,
refresh_token
redirect_uri
string
refresh_token
string
scope
string

Antwort

default - */*
category
string
erforderlich

The error category

correlationId
string<uuid>
erforderlich

A unique identifier for the request. Include this value with any error reports or support tickets

Beispiel:

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

message
string
erforderlich

A human readable message describing the error along with remediation steps where appropriate

Beispiel:

"An error occurred"

context
object

Context about the error condition

Beispiel:

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

errors
object[]

further information about the error

A map of link names to associated URIs containing documentation about the error or recommended remediation steps

subCategory
string

A specific category that contains more specific detail about the error

Last modified on April 9, 2026