Integrations Permissions and Troubleshooting
Missing menus or failed syncs are usually the plan, connector assignment or permissions. Your company admin manages roles under Management → Users.
Permissions, in plain language
| To do this | You need |
|---|---|
| See the hub, settings and mappings | View Integrations |
| Save credentials, connect or disconnect | Manage Integration Settings |
| Save or apply field mappings | Manage Integration Mappings |
| Read the Execution log | View Integration Logs |
| Toast screens and reports | View Toast Integration |
| Toast connection and summary email | Manage Toast Settings |
| Toast product and location mappings | Manage Toast Mappings |
| Toast sync, imports, comparison, cutover | Run Toast Sync |
| Toast Sync logs | View Toast Logs |
The Integrations Manager role grants the four hub permissions without broader company-settings access.
Hub troubleshooting
| Symptom | Cause and fix |
|---|---|
| No Integrations or Integration hub menu | Not on your plan, or you lack the permissions. Ask your administrator |
| A connector card shows "not found" | The connector is not assigned to your company |
| A hub run shows Failed | Read the message in the Execution log, then check credentials, field mappings and the external system's status |
| QuickBooks or Xero says reconnect | The authorization was revoked or expired. Click Reconnect |
| Xero connected but nothing syncs | No organisation is selected. Use Change organisation |
| Invoices land in the wrong account | Open Account mapping, click Suggest matches, then clear the remainder |
| Xero refuses a payment | Map your cash or bank ledger account |
| A record stopped syncing | It changed on both sides. Open Conflicts, choose the winner and mark it resolved |
| Shopify orders do not arrive | Check the webhook is registered for orders/create, the write-back target is Import as sale, and a default warehouse is set |
| Webhook sent but nothing changed | The target may be Log only. Check the Execution log |
Toast troubleshooting
| Symptom | Cause and fix |
|---|---|
| No Toast Integration menu | The Toast module is separate from the hub. Ask your administrator to enable it and assign permissions |
| Nothing has synced | Sync mode must not be Off. Click Test connection, then read Sync logs. If still silent, ask whether the Toast sync job is paused |
| Test connection fails | Check the client ID and secret, restaurant GUID and Toast API access |
| An item did not come off stock | It is not matched yet. Check Product mappings |
| A sale failed with "no stock" | Count the item or set it to Flexible, then re-post failed lines |
| Sales on the wrong day, or times hours off | Check the closeout hour and that the Company Profile time zone matches the restaurant |
| No waste figures | Waste tracking is off in Toast, or waste appears a day late |
| A sale was voided after its day went through | Use Correct a day for that date |
| A file upload went in twice | Import History → Reverse (uploaded files only) |
| An upload is rejected | The file is over the size limit. Split it |
| Failure emails arrive | The sync failed several times in a row. Click Test connection; the emails stop once a sync succeeds |
Limitations
- Toast: Biznsbook reads from Toast only. Sync is a two-hour poll with no real-time webhook, comparison works only for items with quantity tracking, and deliveries are not read from Toast.
- QuickBooks and Xero two-way sync is Beta.
- HubSpot, Salesforce and Square use a pasted access token, not an OAuth button.
Related articles
Learn more about Biznsbook Integration Hub on biznsbook.com.