This guide will be removed on April 29, 2022. Please use our new, easier-to-use Toast technical documentation site. All updated content is on the new site.

API client scope reference

The following table describes the scopes that determine what actions your Toast API client has permission to perform.

API

Scope Type

Scope Name

Description

Cash management

Read

cashmgmt:read

Allows reading from the cash management API.

Configuration

Read

config:read

Allows reading from the configuration API.

Credit cards

Write

credit_cards.authorization:write

Allows authorization of payments through the credit cards API.

Kitchen

Read

kitchen:read

Allows reading from the kitchen API.

Labor

Read

labor:read

Allows reading all data except employees from the labor API.

Labor

Read

labor.employees:read

Allows reading employee information from the labor API.

Labor

Write

labor.employees:write

Allows updating employee information in the labor API.

Labor

Write

labor.jobs:write

Allows updating job information in the labor API.

Labor

Write

labor.shifts:write

Allows updating shift information in the labor API.

Menus

Read

menus.channel:read

Allows reading from the menus API V3.

Note

Ordering partner integrations must use V3 of the menus API, which requires the menus.channel:read scope. Because V3 currently only supports ordering partner integrations, all other integration partners should continue to use menus API V2, which requires the menus:read scope.

Menus

Read

menus:read

Allows reading from the menus API V2.

Note

Because menus API V3 currently only supports ordering partner integrations, all other integration partners should continue to use menus API V2, which requires the menus:read scope.

Order management configuration

Read

digital_schedule:read

Allows reading from the order management configuration API.

Orders

Read

orders:read

Allows reading from the orders API with the exception of guest information.

if your API client creates orders, then to read orders, it must have both the orders:read scope and the orders.channel:read scope.

Orders

Read

orders.channel:read

Allows API clients that submit orders to the Toast platform to read from the orders API.

To read orders, the API client must have both the orders:read scope and the orders.channel:read scope.

API clients that have the orders.channel:read scope can only read the orders that they submitted. They cannot read orders from any other source.

Orders

Read

delivery_info.address:read

Allows reading guest delivery address information from the orders API.

Orders

Read

guest.pi:read

Allows reading guest and curbside pickup information from the orders API.

Orders

Write

orders.delivery_info:write

Allows updating delivery information from the orders API.

Orders

Write

orders.discounts:write

Allows adding discounts to orders using the orders API.

Orders

Write

orders.items:write

Allows adding items to orders using the orders API.

Orders

Write

orders.orders:write

Allows posting orders orders using the orders API.

Orders

Write

orders.payments:write

Allows adding payments and tips to orders using the orders API.

Restaurant availability

Restaurants

Read

restaurants:read

Allows reading from the restaurant availability API.

Allows reading from the restaurants API.

Stock

Read

stock:read

Allows reading from the stock API.

Stock

Write

stock:write

Allows updating stock status for menu items (and modifier option item references) using the stock API.