> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Sample Flows

## Article: Sample Flows

## Article Link: https://dev.wix.com/docs/api-reference/app-management/app-permissions/sample-flows.md

## Article Content:

# 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](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](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/configure-permissions-for-your-app.md#step-1--identify-required-permissions).

3. Find the ID of the required permission by searching for it on the [Permissions page](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](https://dev.wix.com/docs/rest/app-management/app-permissions/create-app-permission.md) 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](https://dev.wix.com/docs/build-apps/get-started/overview/the-wix-ecosystem.md).