Skip to main content

Access Scopes

Access scopes act as gatekeepers, controlling the data your extension can access within a seller’s store. These scopes, granted by the seller, define your extension's permissions to read, write, or modify information such as orders, products, and customer details. Only Platform APIs require access scopes.

Company Permissions

Company Profile

Manage profile details, including brands, selling locations, and other company-related properties.

ScopeDescription
company/brands/readGet brands of a company.
company/brands/writeCreate, update and delete brands of a company.
company/locations/readGet inventory locations of a company.
company/locations/writeCreate, update and delete inventory locations of a company.
company/properties/readGet specific company properties such as name, address and contact information.
company/properties/writeCreate, update, and delete specific company properties such as name, address, and contact information.
company/legal/readGet legal documents about the company.
company/legal/writeWrite legal documents about the company.

Sales Channels

View and manage applications in a company.

company/applications/readGet list of applications and their details in a company.
company/applications/writeManage applications of a company.

Products

Create and manage products, price and inventory details at the company-level. Catalog data is defined at the company level and is consumed by all the applications across the company.

company/products/readGet catalog data of a company.
company/products/writeManage catalog data of a company.
company/inventory/readGet inventory details of products in a company.
company/inventory/writeManage inventory details of products in a company.
company/price_rules/readGet price rules of an application including discounts, coupons and promotions at the company level.
company/price_rules/writeManage price rules of an application including discounts, coupons and promotions at the company level.

Orders

View and manage orders received across all the applications in a company.

company/orders/readGet orders and their details across all the applications in the company.
company/orders/writeProcess orders across all the applications in the company.

Logistics

Read and edit delivery-related configurations at the company-level.

company/logistics/readGet logistics configurations at the company-level.
company/logistics/writeManage logistics configurations at the company-level.

Analytics

Get insights on the performance of the company across all sales channels with an option to download the graphs and reports.

company/analytics/readGet company-level analytics reports.
company/analytics/writeCreate company-level analytics data.

Settings

View and edit company-level configurations.

company/settings/readGet company settings.
company/settings/writeModify company settings.
company/shipping/readGet delivery zones of a company.
company/shipping/writeManage delivery zones of a company.

Custom Fields and Objects

Perform create, read, update and delete operations on meta objects and fields at the company-level.

company/meta/readGet meta objects and fields data.
company/meta/writeCreate, read, update and delete operations on meta objects and fields.

Application Permissions

Customer

View and manage all the customer data received in an application.

ScopeDescription
application/customers/readGet details of customers registered in the application.
application/protected_customer_data/readGet personal data of customers registered in the application.
application/customers/writeManage registered customers in the application.

Marketing

Create and manage an application's marketing including promotions, collections, coupons, rewards and blogs.

application/products/readGet products and their details for a specific application.
application/products/writeManage products of a specific application.
application/price_rules/readGet price rules of an application including discounts, coupons and promotions at the company-level.
application/price_rules/writeManage price rules of an application including discounts, coupons and promotions at the company-level.
application/content/readGet application content like blogs, short links and pages.
application/content/writeEdit application content like blogs, short links and pages.
application/rewards/readGet details of rewards of an application.
application/rewards/writeManage rewards of an application.

Communication

Manage campaigns, communication templates and trigger event-based communications to enhance user engagement within the application.

application/communications/readGet communications configurations of the application.
application/communications/writeEdit communications configurations of the application.

Customer Support

Manage the help desk for storing and processing the customer service requests.

application/customer_support/readGet customer support requests of an application.
application/customer_support/writeManage customer support requests of an application.

Appearance

Manage the themes, layouts and navigation for an application.

application/themes/readGet details of themes available in the application.
application/themes/writeManage and edit themes available in the application.
application/navigation/readGet application navigation settings.
application/navigation/writeModify application navigation settings.

Products

Manage products, price and inventory details of an application.

application/products/readGet products and their details for a specific application.
application/products/writeManage products of a specific application.

Payments

Manage payment and payout-related configurations of a specific application.

application/payment/readGet payment and payout-related configurations of a specific application.
application/payment/writeManage payment and payout-related configurations of a specific application.

Settings

Manage application-level settings for catalog, cart, payments, logistics and other configurations.

application/settings/readGet application settings.
application/settings/writeManage application settings.
application/integrations/readGet list of integrations in the application.
application/integrations/writeModify integrations of an application.
application/inventory/readGet inventory of products in an application.
application/inventory/writeManage inventory of products in an application.
application/cart/readGet cart configurations and data for a specific application.
application/cart/writeEdit cart configurations and data for a specific application.
application/currency/readGet currency configurations of a specific application.
application/currency/writeEdit currency configurations of a specific application.
application/credit_note/readGet credit note configurations of a specific application.
application/credit_note/writeEdit credit note configurations of a specific application.
application/logistics/readGet logistics configurations of a specific application.
application/logistics/writeEdit logistics configurations of a specific application.
application/data_loader/readGet data loader configurations of a specific application.
application/data_loader/writeEdit data loader configurations of a specific application.
application/legal_docs/readGet application legal documents.
application/legal_docs/writeEdit application legal documents.
application/payments/readGet payment and payout-related configurations of a specific application.
application/payments/writeManage payment and payout-related configurations of a specific application.
application/products/readGet products and their details for a specific application.
application/products/writeManage products of a specific application.

Custom Fields and Objects

Perform create, read, update and delete operations on meta objects and fields for a specific application.

application/meta/readGet meta objects and fields data.
application/meta/writeCreate, read, update and delete operations on meta objects and fields.

Was this section helpful?