Introspect Access/Refresh Token

POST

https://auth.calendly.com/oauth/introspect

Use this endpoint to introspect an access/refresh token.

This endpoint expects an object.

client_idstringRequired

The ID provided by Calendly for the web application

client_secretstringRequired

The secret provided by Calendly

tokenstringRequired

The access/refresh token provided by Calendly

activeboolean

Boolean indicator of whether or not the presented token is currently active

scopestringOptional

The scope of the access token

client_idstringOptional

The ID provided by Calendly for the web application

token_typestringOptional

The token type (currently this is always “Bearer”)

expdoubleOptional

The UNIX timestamp in seconds when the access-token will expire

iatdoubleOptional

The UNIX timestamp in seconds when the access-token was originally issued

ownerstringOptionalformat: "uri"

A link to the resource that owns the token (currently, this is always a user)

organizationstringOptionalformat: "uri"

A link to the owner's current organization

400

Bad Request Error

401

Unauthorized Error

1	const url = 'https://auth.calendly.com/oauth/introspect';
2	const options = {
3	method: 'POST',
4	headers: {'Content-Type': 'application/x-www-form-urlencoded'},
5	body: new URLSearchParams('')
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

1	{
2	"active": true,
3	"scope": "default",
4	"client_id": "123",
5	"token_type": "Bearer",
6	"exp": 1601325434,
7	"iat": 1601318234,
8	"owner": "https://api.calendly.com/users/EBHAAFHDCAEQTSEZ",
9	"organization": "https://api.calendly.com/organizations/EBHAAFHDCAEQTSEZ"
10	}