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:

  1. Go to your app's page in the Wix Developers Center.
  2. Click Permissions in the side menu (under Build Your App).
  3. Click + Add Permissions
  4. Choose the relevant category for the permission, and then select the permission scope.
  5. 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.
  6. 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.

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

NameDescription
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 EmailRequest permission to read site owner's email

Marketing

NameDescription
Manage Ads.txtRequest permission to read and manage the site's ads.txt file
Manage Email SubscriptionsRequest permission to read and modify the subscription status for email addresses
Read Form SubmissionsRequest permission to read the site's Wix Forms submissions
Read Email MarketingRequest permission to read email marketing data.
Manage Email MarketingRequest permission to read, create and manage email marketing campaigns.

Wix Stores

NameDescription
Read OrdersRequest permission to read the site's Wix Stores order info
Read ProductsRequest permission to read the site's Wix Stores product and inventory info
Manage OrdersRequest permission to read, create and modify the site's Wix Stores orders
Manage ProductsRequest permission to read, create and modify the site's Wix Stores products and inventory
Read Abandoned CartsRequest permission to read customer's abandoned carts.

Pricing Plans

NameDescription
Read Pricing PlansRequest permission to read the site's pricing plans.
Manage Pricing PlansRequest permission to read and manage the site's pricing plans.
Read OrdersRequest permission to read the site's public pricing plans and all orders
Manage OrdersRequest permission to manage the site's pricing plan orders

Site Properties

NameDescription
Manage Business ScheduleRead and manage the site's business schedule information

Wix Payments

NameDescription
Read TransactionsRequest permission to read the site's Wix Payments transactions
Manage TransactionsRequest permission to read, create and capture payment transactions
Manage RefundsRequest permission to read transactions and manage refunds
Manage DisputesRequest permission to read transactions and manage disputes, including evidence upload
NameDescription
Read Bookings - Public DataRequest permission to read the business's bookings info, including staff member data (calendar, services, etc.)
Read Bookings - Including ParticipantsRequest permission to read the business's bookings info, and its bookings with staff member and participant data
Manage BookingsRequest 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 CalendarRequest permission to read the site's bookings calendar info, including all sessions, scheduleable assets, and staff member data
Read Bookings Calendar AvailabilityRequest permission to read the site's bookings calendar availability

Wix Loyalty

NameDescription
Read LoyaltyRequest permission to read the site's installed Wix Loyalty Program, including program and accounts
Manage LoyaltyRequest permission to manage the site's installed Wix Loyalty Program, including program and accounts

Wix Restaurants

NameDescription
Read OrdersRequest permission to read site's Wix Restaurants orders
Manage OrdersRequest permission to manage the site's restaurant catalogs
Read Restaurant CatalogsRequest permission to read the site's restaurant catalogs
Manage Restaurant CatalogsRequest permission to manage the site's restaurant catalogs

Contacts and Members

NameDescription
Read MembersRequest permission to read member data
Read BadgesRequest permission to read the site's member badges
Manage BadgesRequest permission to manage the site's member badges
Manage ContactsRequest permission to read, create and modify the site's contact info
Manage Contact Extended FieldsRequest permission to read and modify the extended fields saved to site contacts
Read Activity CountersRequest permission to read the site's member activity counters
Read ContactsRequest permission to read the site's contact info
Manage Contact LabelsRequest permission to read and modify labels available in the site contact list and saved to site contacts
Manage MembersRequest permission to read, create and change member data
Manage Activity CountersRequest permission to manage the site's member activity counters

Wix Events

NameDescription
Read Basic Events Order InfoRequest permission to read basic order info
Read EventsRequest permission to read basic event info
Manage OrdersRequest permission to read, create and change orders
Manage Guest ListRequest permission to read, create and change event tickets, guest lists and RSVPs
Manage Ticket DefinitionsRequest permission to read, create and change event ticket definitions
Manage EventsRequest permission to read, create and change events
Read Event Tickets and Guest ListRequest permission to read event tickets and guest lists

Coupons

NameDescription
Manage CouponsRequest permission to read, create and modify the site's Wix coupons

Wix Blog

NameDescription
Read BlogRequest permission to read published blog posts, tag, and category data

Wix Chat

NameDescription
Manage ChatsRequest permission to read and send chat message
Manage Inbox MessagesRequest permissions to read and send chat messages on behalf of the site and visitors
Read Inbox MessagesRequest permission to read chat messages

Currencies

NameDescription
Manage CurrenciesRequest permission to read the site's supported currencies and conversion rate values

Site Content

NameDescription
Manage FAQRequest permissions to read, create and update FAQ question and answer data
Read FAQRequest permission to read FAQ question and answer data

Business Info

NameDescription
Manage Consent PolicyRequest permission to read and manage the default consent policy

Wix Forums

NameDescription
Read ForumsRequest permission to read all Wix Forum posts and category data

Community

NameDescription
Manage Social GroupsRequest permission to read, create and manage Wix groups

Cashier

NameDescription
Read PaymentsRequest permission to read the site's Wix Cashier transactions

Multi Location

NameDescription
Read LocationsRequest permission to manage the site's locations
Manage LocationsRequest permission to read the site's locations
Was this helpful?
Yes
No