Saltar al contenido principal
POST
/
oauth
/
v1
/
token
Actualizar un token de acceso
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
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt

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

Supported products

Parámetros de consulta

client_secret
string

Una credencial confidencial que solo conocen la aplicación y el servidor de autorización, utilizada para autenticar la identidad del cliente cuando realiza solicitudes de token.

refresh_token
string

Una credencial de larga duración emitida junto con un token de acceso que puede intercambiarse por un nuevo token de acceso junto con las credenciales del cliente cuando caduca el access_token actual, lo que permite seguir accediendo a la API sin que el usuario tenga que volver a autenticarse.

Cuerpo

application/x-www-form-urlencoded
client_id
string
client_secret
string
code
string
code_verifier
string
grant_type
enum<string>
Opciones disponibles:
authorization_code,
client_credentials,
refresh_token
redirect_uri
string
refresh_token
string
scope
string

Respuesta

successful operation

accessToken
string

El token de acceso utilizado para la autenticación en las solicitudes a la API.

expiresIn
integer<int64>

La duración en segundos de la validez del token de acceso.

hubId
integer<int32>

El ID de la cuenta de HubSpot asociada al token.

idToken
string

El token de ID que contiene declaraciones de identidad sobre el usuario.

scopes
string[]

Una matriz de cadenas que indican los alcances

tokenType
string

El tipo de token, que suele indicar el esquema de autenticación. Normalmente es "portador".

userId
integer<int32>

El ID del usuario de HubSpot para el que se creó el token.

Last modified on April 14, 2026