---
title: "OAuth token endpoint"
method: POST
path: "/oauth/2026-03/token"
tags: ["Advanced"]
---

# OAuth token endpoint

`POST /oauth/2026-03/token`

Authenticates a client and returns access and refresh tokens.

## Response `200`

successful operation

- union
  - AuthOauthAccessTokenResponse
    - `access_token` string, required
    - `expires_in` integer, required
    - `hub_id` integer
    - `id_token` string
    - `refresh_token` string, required
    - `scopes` string[]
    - `token_type` string, required
    - `token_use` 'access_token', required
    - `user_id` integer
  - AuthOauthClientCredentialsTokenResponse
    - `access_token` string, required
    - `expires_in` integer, required
    - `hub_id` integer
    - `id_token` string
    - `scopes` string[]
    - `token_type` string, required
    - `token_use` 'client_credentials', required
    - `user_id` integer

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/versions/f9c7181056c5/schema)