Skip to main content

CreateAccessTokenRequest

Body for POST /access_token, which mints a short-lived token/secret pair to hand to an untrusted client so your consumer secret never leaves your server. Every property is optional.

ttl_secondsinteger

How long the issued token stays valid, in seconds. Defaults to 86400 (24 hours) when omitted or when the value is not a number.

Values above 2592000 (30 days) are silently clamped rather than rejected: the call still succeeds with success: true, and the token you get back simply expires earlier than you asked for. There is no field in the response reporting the granted lifetime, so do not assume the value you sent was honoured.

Default value: 86400
CreateAccessTokenRequest
{
"ttl_seconds": 86400
}