# About the App Permissions API

The App Permissions API allows you to manage the permissions your app needs for its functionality. When users install your app, they need to grant your app the permissions it needs to allow it to access their site data and make API calls on their behalf. Permissions are granular and can be tailored to your app's specific needs, such as creating a [business location](fallback::https://dev.wix.com/docs/rest/business-management/locations/create-location) or [setting a member's privacy settings](fallback::https://dev.wix.com/docs/rest/crm/members-contacts/members/member-privacy-settings/set-member-privacy-settings).

Learn more [about permissions for Wix apps](fallback::https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).

With the Wix App Permissions API, you can:

- [List permissions](fallback::https://dev.wix.com/docs/rest/app-management/app-permissions/list-app-permissions) associated with a specific app.
- [Create new permissions](fallback::https://dev.wix.com/docs/rest/app-management/app-permissions/create-app-permission) for an app.
- [Delete existing permissions](fallback::https://dev.wix.com/docs/rest/app-management/app-permissions/delete-app-permission) from an app.

> **Note**: After adding or removing a permission, it might take up to 5 minutes for the update to appear across the [Wix ecosystem](fallback::https://dev.wix.com/docs/build-apps/get-started/overview/the-wix-ecosystem).

## Before you begin

It's important to note the following points before starting to code:

- You must have a [Wix app](fallback::https://dev.wix.com/docs/build-apps/get-started/overview/about-wix-apps). Learn more [about developing apps](fallback::https://dev.wix.com/docs/build-apps/develop-your-app/about-developing-apps).
- You must have an [API key](fallback::https://dev.wix.com/docs/rest/articles/get-started/api-keys) with the account-level **Manage Custom Apps** permission from the account that owns the app.
- [Identify the permissions your app needs](fallback::https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/configure-permissions-for-your-app#step-1--identify-required-permissions) by checking which Wix APIs it uses.

## Use case

- [Add a permission for your app](fallback::https://dev.wix.com/docs/rest/app-management/app-permissions/sample-flows)

@sdk_package_setup

# Sample Flow

This article presents a possible use case and corresponding sample flow that you can support. This can be a helpful jumping off point as you plan your implementation.

## Add a permission to your app

To add a permission to your app, such as the **Manage Events** permission:

1. Find your app's ID on the [Home page](fallback::https://manage.wix.com/app-selector?title=Select+an+App&primaryButtonText=Select+Site&actionUrl=https%3A%2F%2Fdev.wix.com%2Fapps%2F%7BappId%7D%home) in the app's dashboard.

2. In the API reference, locate the method your app needs and [identify the required permission](fallback::https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/configure-permissions-for-your-app#step-1--identify-required-permissions).

3. Find the ID of the required permission by searching for it on the [Permissions page](fallback::https://dev.wix.com/app-selector?title=Select+an+App&primaryButtonText=Select+Site&actionUrl=https%3A%2F%2Fdev.wix.com%2Fapps%2F%7BappId%7D%2Fdev-center-permissions/add) in the app's dashboard.

4. Call the [Create App Permission](fallback::https://dev.wix.com/docs/rest/app-management/app-permissions/create-app-permission) method with the app ID and permission ID:

```json
{
  "appPermission": {
    "appId": "73c38f4e-a8f3-4b7c-9d87-23fc578793ec",
    "permission": {
      "permissionId": "SCOPE.DC-EVENTS.MANAGE-EVENTS"
    }
  }
}
```

The method returns a response such as:

```json
{
  "appPermission": {
    "appId": "73c38f4e-a8f3-4b7c-9d87-23fc578793ec",
    "permission": {
      "permissionId": "SCOPE.DC-EVENTS.MANAGE-EVENTS"
    },
    "createdDate": "2025-05-05T08:53:20.154Z",
    "updatedDate": "2025-05-05T08:53:20.154Z"
  }
}
```

Now, when users install your app on a site, they are asked to grant it the **Manage Events** permission.

> **Note**: It might take up to 5 minutes for the permission to update across the [Wix ecosystem](fallback::https://dev.wix.com/docs/build-apps/get-started/overview/the-wix-ecosystem).

Coding Examples

Overview

Sled Tests

Go Headless

Extend Websites with SDK

Build Apps

Client (Deprecated)

API Preview

Wix CLI

Ricos

Extend Websites with Velo

API Reference

Velo

Picasso

GraphQL (Alpha)