> 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/application.md).

# Application

## Example

```javascript
{
  "name": "test app",
  "website": null,
  "vapid_key": "BCk-QqERU0q-CfYZjcuB6lnyyOYfJ2AifKqfeGIm7Z-HiTU5T9eTG5GxVA0_OH5mMlI4UkkDTpaZwozy0TzdZ2M="
}
```

## Required attributes

### `name`

**Description:** The name of your application.\
**Type:** String\
**Version history:** Added in 0.9.9

## Optional attributes

### `website`

**Description:** The website associated with your application.\
**Type:** String (URL)\
**Version history:** Added in 0.9.9

### `vapid_key`

**Description:** Used for Push Streaming API. Returned with [POST /api/v1/apps](/mastodon/methods/apps.md#create-an-application). Equivalent to [PushSubscription#server\_key](/mastodon/entities/push-subscription.md#server_key)\
**Type:** String\
**Version history:** Added in 2.8.0

## Client attributes

### client\_id

**Description:** Client ID key, to be used for obtaining OAuth tokens\
**Type:** String\
**Version history:** Added in 0.9.9

### client\_secret

**Description:** Client secret key, to be used for obtaining OAuth tokens\
**Type:** String\
**Version history:** Added in 0.9.9

## See also

* [Status#application](/mastodon/entities/status.md#application)
* [Create an application (POST /api/v1/apps)](/mastodon/methods/apps.md#create-an-application)

{% content-ref url="/pages/-Lr2Dehn4lq2gVBLRTnt" %}
[Status](/mastodon/entities/status.md)
{% endcontent-ref %}

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

{% embed url="<https://github.com/tootsuite/mastodon/blob/master/app/serializers/rest/application_serializer.rb>" %}
app/serializers/rest/application\_serializer.rb
{% endembed %}