documentation/content/en/entities/application.md

---

title: Application description: Represents an application that interfaces with the REST API to access accounts or post statuses. menu: docs:

parent: entities

---

Example

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

Required attributes

name {#name}

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

Optional attributes

website {#website}

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

vapid_key {#vapid_key}

Description: Used for Push Streaming API. Returned with POST /api/v1/apps. Equivalent to PushSubscription#server_key\ Type: String\ Version history: Added in 2.8.0

Client attributes

client_id {#client_id}

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

client_secret {#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
• Create an application (POST /api/v1/apps)

{{< page-ref page="status.md" >}}

{{< page-ref page="methods/apps.md" >}}

{{< caption-link url="https://github.com/tootsuite/mastodon/blob/master/app/serializers/rest/application_serializer.rb" caption="app/serializers/rest/application_serializer.rb" >}}