TikTok General
OAuth Tokens
Manage oauth tokens within the TikTok General API. This section covers endpoints for working with oauth tokens including retrieval, creation, and management operations.
Get user info
Get information about the currently authenticated TikTok user. Requires a valid OAuth token with an active TikTok session.
Header Parameters
Responses
Response Attributes
Validate refresh token
Check if a stored refresh token is still valid without consuming it. Returns metadata about the session if valid.
This is a public endpoint — no authentication required.
Request Body
RequiredThe refresh token and client ID to validate
The refresh token to validate
The OAuth client ID that issued the token
Responses
Response Attributes
Exchange token
Exchange an authorization code or refresh token for access tokens.
For authorization_code grant:
- code: The authorization code from /oauth/complete
- redirect_uri: Must match the original redirect_uri
For refresh_token grant:
- refresh_token: A valid refresh token
Request Body
RequiredToken request parameters
Required for authorization_code grant
Required for authorization_code grant
Required for refresh_token grant
Responses
Response Attributes
Revoke token
Revoke an access token or refresh token (RFC 7009). This endpoint always returns success for valid client credentials, even if the token was already revoked or invalid.
Request Body
RequiredRevoke request parameters
Responses
Response Attributes
Introspect token
Introspect a token to determine its state (RFC 7662). Returns active: true/false along with token metadata. Works for both access tokens and refresh tokens.
Request Body
RequiredIntrospection request parameters
Responses
Response Attributes
RFC 7662 Token Introspection response
Get public client
Get public information about an OAuth client by client_id. This endpoint is used during the authorization flow to display client information to the user before they authorize.
Does not require authentication. Does not expose sensitive information like client_secret_hash.
Path Parameters
Responses
Response Attributes