For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
LoginStart trialGet a demo
  • Welcome
    • Getting Started
    • Create an API Key
    • Pagination
    • Rate Limiting
    • No-Code Integrations
  • Webhooks
  • OAuth2
      • POSTCreate token
      • POSTRevoke token
      • POSTIntrospect token
      • GETGet token info
  • API Reference
LogoLogo
LoginStart trialGet a demo
OAuth2Tokens

Revoke token

POST
https://app.beehiiv.com/oauth/revoke
POST
/oauth/revoke
$curl -X POST https://app.beehiiv.com/oauth/revoke \
>     -H "Content-Type: application/json" \
>     -d '{
>  "token": "2YotnFZFEjr1zCsicMWpAA",
>  "token_type_hint": "access_token",
>  "client_id": "WDgKDt_bHOXUfWRhGf2ovKZmFHQ9r_Erd01IPmz_boc",
>  "client_secret": "your-client-secret"
>}'
1{}

Revokes an access token or refresh token. Send parameters as application/x-www-form-urlencoded.

Was this page helpful?
Previous

Introspect token

Next
Built with

Request

This endpoint expects an object.
tokenstringRequired
The access or refresh token to revoke.
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.

Response

OK

Errors

401
O Auth Unauthorized Error
403
O Auth Forbidden Error