How to Add Permissions
You can view and manage user data – like an order made on a user's site – by subscribing to webhooks or calling our APIs. To access this data, users must give you permission to do so.
The permissions you select in the Wix Developers Center will dictate which type of authorization site owners will provide and which data you can access. Site owners will see a list of the permissions you've requested during the installation flow.
Add permissions
You need to add a permission for each type of data you want to access. Here's how:
- Go to your app's page in the Wix Developers Center.
- Click Permissions in the side menu (under Build Your App).
- Click + Add Permissions.
- Choose the relevant category for the permission, and then select the permission scope.
- Some high-level Permissions, like Read Stores, include multiple associated Permissions e.g., Read Product and Read Orders. This means you only need to add the Read Stores Permission.
- Click Save.
When a new user installs your app, they'll be asked to grant your app permission for each permission you've added.
Adding webhooks?
Required permissions are automatically added when you add a webhook to your app.
Important:
Never ask for more permissions than you need. Determine the scope of your app permissions thoroughly before requesting them. If you intend to add new functionality in the future that requires additional permissions, let us know.
How a user grants consent for permissions
When a user installs your app they'll be shown all the permissions your app requires and will need agree to them before proceeding.
Available permissions
Here's a list of some of the key permissions available for third-party use:
Wix Developers
| Name | Description |
|---|---|
| Manage Your App (This permission is added automatically) | Request permission to view basic site info, such as site name, language, and currency, and your business info, such as business email, phone number, address, and more. |
| Manage Embedded Scripts (This permission is added automatically) | Request permission to read, create and modify embedded scripts on the site |
| Read Site Owner Email | Request permission to read site owner's email |
Marketing
| Name | Description |
|---|---|
| Manage Ads.txt | Request permission to read and manage the site's ads.txt file |
| Manage Email Subscriptions | Request permission to read and modify the subscription status for email addresses |
| Read Form Submissions | Request permission to read the site's Wix Forms submissions |
| Read Email Marketing | Request permission to read email marketing data. |
| Manage Email Marketing | Request permission to read, create and manage email marketing campaigns. |
Wix Stores
| Name | Description |
|---|---|
| Read Orders | Request permission to read the site's Wix Stores order info |
| Read Products | Request permission to read the site's Wix Stores product and inventory info |
| Manage Orders | Request permission to read, create and modify the site's Wix Stores orders |
| Manage Products | Request permission to read, create and modify the site's Wix Stores products and inventory |
| Read Abandoned Carts | Request permission to read customer's abandoned carts. |
Pricing Plans
| Name | Description |
|---|---|
| Read Pricing Plans | Request permission to read the site's pricing plans. |
| Manage Pricing Plans | Request permission to read and manage the site's pricing plans. |
| Read Orders | Request permission to read the site's public pricing plans and all orders |
| Manage Orders | Request permission to manage the site's pricing plan orders |
Site Properties
| Name | Description |
|---|---|
| Manage Business Schedule | Read and manage the site's business schedule information |
Wix Payments
| Name | Description |
|---|---|
| Read Transactions | Request permission to read the site's Wix Payments transactions |
| Manage Transactions | Request permission to read, create and capture payment transactions |
| Manage Refunds | Request permission to read transactions and manage refunds |
| Manage Disputes | Request permission to read transactions and manage disputes, including evidence upload |
Wix Bookings
| Name | Description |
|---|---|
| Read Bookings - Public Data | Request permission to read the business's bookings info, including staff member data (calendar, services, etc.) |
| Read Bookings - Including Participants | Request permission to read the business's bookings info, and its bookings with staff member and participant data |
| Manage Bookings | Request permission to read, create and change the site's bookings, schedules, sessions, services and resources, including site owner data, staff member data, and participant data |
| Read Bookings Calendar | Request permission to read the site's bookings calendar info, including all sessions, scheduleable assets, and staff member data |
| Read Bookings Calendar Availability | Request permission to read the site's bookings calendar availability |
Wix Loyalty
| Name | Description |
|---|---|
| Read Loyalty | Request permission to read the site's installed Wix Loyalty Program, including program and accounts |
| Manage Loyalty | Request permission to manage the site's installed Wix Loyalty Program, including program and accounts |
Wix Restaurants
| Name | Description |
|---|---|
| Read Orders | Request permission to read site's Wix Restaurants orders |
| Manage Orders | Request permission to manage the site's restaurant catalogs |
| Read Restaurant Catalogs | Request permission to read the site's restaurant catalogs |
| Manage Restaurant Catalogs | Request permission to manage the site's restaurant catalogs |
Contacts and Members
| Name | Description |
|---|---|
| Read Members | Request permission to read member data |
| Read Badges | Request permission to read the site's member badges |
| Manage Badges | Request permission to manage the site's member badges |
| Manage Contacts | Request permission to read, create and modify the site's contact info |
| Manage Contact Extended Fields | Request permission to read and modify the extended fields saved to site contacts |
| Read Activity Counters | Request permission to read the site's member activity counters |
| Read Contacts | Request permission to read the site's contact info |
| Manage Contact Labels | Request permission to read and modify labels available in the site contact list and saved to site contacts |
| Manage Members | Request permission to read, create and change member data |
| Manage Activity Counters | Request permission to manage the site's member activity counters |
Wix Events
| Name | Description |
|---|---|
| Read Basic Events Order Info | Request permission to read basic order info |
| Read Events | Request permission to read basic event info |
| Manage Orders | Request permission to read, create and change orders |
| Manage Guest List | Request permission to read, create and change event tickets, guest lists and RSVPs |
| Manage Ticket Definitions | Request permission to read, create and change event ticket definitions |
| Manage Events | Request permission to read, create and change events |
| Read Event Tickets and Guest List | Request permission to read event tickets and guest lists |
Coupons
| Name | Description |
|---|---|
| Manage Coupons | Request permission to read, create and modify the site's Wix coupons |
Wix Blog
| Name | Description |
|---|---|
| Read Blog | Request permission to read published blog posts, tag, and category data |
Wix Chat
| Name | Description |
|---|---|
| Manage Chats | Request permission to read and send chat message |
| Manage Inbox Messages | Request permissions to read and send chat messages on behalf of the site and visitors |
| Read Inbox Messages | Request permission to read chat messages |
Currencies
| Name | Description |
|---|---|
| Manage Currencies | Request permission to read the site's supported currencies and conversion rate values |
Site Content
| Name | Description |
|---|---|
| Manage FAQ | Request permissions to read, create and update FAQ question and answer data |
| Read FAQ | Request permission to read FAQ question and answer data |
Business Info
| Name | Description |
|---|---|
| Manage Consent Policy | Request permission to read and manage the default consent policy |
Wix Forums
| Name | Description |
|---|---|
| Read Forums | Request permission to read all Wix Forum posts and category data |
Community
| Name | Description |
|---|---|
| Manage Social Groups | Request permission to read, create and manage Wix groups |
Cashier
| Name | Description |
|---|---|
| Read Payments | Request permission to read the site's Wix Cashier transactions |
Multi Location
| Name | Description |
|---|---|
| Read Locations | Request permission to manage the site's locations |
| Manage Locations | Request permission to read the site's locations |
Was this helpful?