Integrations Permissions and Troubleshooting
Missing menus or failed syncs are usually licensing, connector assignment, or Toast permissions. Administrators manage roles under Settings → Users & roles.
Permissions, in plain language
| You need to… | Typically requires |
|---|---|
| Hub connector settings | Manage company settings (or Integrations manage rights) |
| Toast Settings / reports | View Toast; save settings needs Manage Toast Settings |
| Toast restaurants, product & location mappings | Manage Toast mappings |
| Import items / sales / daily / history | Run Toast Sync |
| Sync logs / Event log | View Toast logs |
| Product Group Rules | View inventory to see; Manage inventory to edit/apply |
Frequently asked questions
No Integrations / Integration hub menu. Integrations module not licensed, or your user lacks company-settings / Integrations permissions.
No Toast Integration sidebar. Toast is licensed separately from the Hub. Confirm Toast is enabled and your Toast permissions are assigned.
Connector card missing or unavailable. SiteAdmin has not assigned that connector to your tenant.
Toast Test Connection fails. Check Client ID / secret, restaurant GUID, and Toast API access for that restaurant.
Expected automatic Toast API sync. Recurring sync is off. Use Sync Now or CSV Daily import.
Sales import skipped rows. Fix Product mappings. Unmapped items often show a sidebar badge.
Stock wrong after a variant sale. Set the conversion factor on the mapping; stock tracks on the master item.
Waste not deducted. Enable Waste count on the Toast Product Mix export, then re-import.
Upload rejected. File over 20 MB — split or compress the CSV.
Hub execution Failed. Read the execution log message; verify credentials, field mappings, and the external system's status.