beehiiv Developer Documentation

Returns whether a token is active and metadata about the token. Send parameters as application/x-www-form-urlencoded.

This endpoint expects an object.

tokenstringRequired

The access or refresh token to introspect.

token_type_hintenumOptional

Optional hint to help the server process the token faster.

Allowed values:

client_idstringOptional

OAuth application client ID (uid).

client_secretstringOptional

Required for confidential clients.

activeboolean

scopestring

client_idstring

token_typeenum

The token type returned by OAuth2 token endpoints.

Allowed values:

expinteger

iatinteger

nbfinteger

substring

audstring

issstring

jtistring

400

O Auth Bad Request Error

401

O Auth Unauthorized Error

1	curl -X POST https://app.beehiiv.com/oauth/introspect \
2	-H "Content-Type: application/json" \
3	-d '{
4	"token": "2YotnFZFEjr1zCsicMWpAA",
5	"token_type_hint": "access_token",
6	"client_id": "WDgKDt_bHOXUfWRhGf2ovKZmFHQ9r_Erd01IPmz_boc",
7	"client_secret": "your-client-secret"
8	}'

1	{
2	"active": true,
3	"scope": "posts:read",
4	"client_id": "WDgKDt_bHOXUfWRhGf2ovKZmFHQ9r_Erd01IPmz_boc",
5	"token_type": "Bearer",
6	"exp": 1739988000,
7	"iat": 1739980800,
8	"sub": "org_00000000-0000-0000-0000-000000000000"
9	}