> For the complete documentation index, see [llms.txt](https://mastodon.gitbook.io/mastodon/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mastodon.gitbook.io/mastodon/entities/token.md).

# Token

## Example

```javascript
{
  "access_token": "ZA-Yj3aBD8U8Cm7lKUp-lm9O9BmDgdhHzDeqsY8tlL0",
  "token_type": "Bearer",
  "scope": "read write follow push",
  "created_at": 1573979017
}
```

## Attributes

### `access_token`

**Description:** An OAuth token to be used for authorization.\
**Type:** String\
**Version history:** Added in 0.1.0

### `token_type`

**Description:** The OAuth token type. Mastodon uses `Bearer` tokens.\
**Type:** String\
**Version history:** Added in 0.1.0

### `scope`

**Description:** The OAuth scopes granted by this token, space-separated.\
**Type:** String\
**Version history:** Added in 0.1.0

### `created_at`

**Description:** When the token was generated.\
**Type:** Number (UNIX Timestamp)\
**Version history:** Added in 0.1.0

## See also

* [Example authorization code flow](/mastodon/client/token.md#example-authorization-code-flow)
* [OAuth Scopes](/mastodon/api/oauth-scopes.md)
* [POST /oauth/token](/mastodon/methods/apps/oauth.md#obtain-a-token)

{% content-ref url="/pages/-LsOr9cmE4CIEu79waCk" %}
[oauth](/mastodon/methods/apps/oauth.md)
{% endcontent-ref %}