Your team & distributors
How to invite and manage the people on your Longboard team, set what each can do, and add the distributor organizations that receive your tasting summaries.
Invite a team member
- Open People → Users.
- Click Invite user.
- Enter the person's Email.
- Choose a Primary role from Choose a primary role (the dropdown offers Brand Ambassador, Event Approver, Distributor, Viewer, Territory Manager, Regional Manager, Admin, and Super Admin).
- Optionally add a Display name (optional).
- If you picked the Distributor role, pick the Distributor organization (optional) that appears.
- Click Create and invite.
The invite email is always sent — there's no opt-out. The live role summary on the card tells you what the role grants and whether onboarding applies before you commit.
Bulk-import internal staff from CSV
Use this to create several internal accounts at once — admin, regional/territory manager, or viewer.
- Open People → Users.
- Expand Import staff from CSV.
- Click Download template, or paste rows into the textarea using the header
email,name,phone,role. - Attach your file, or leave your pasted rows in place.
- Click Import staff and check the result area.
- Return to the list and send invitations when you're ready.
Unlike the single invite, CSV import creates accounts but emails no one — you send invitations from the list afterward. Set a manager's territory/region scope in their detail after import. This path won't create ambassadors, approvers, or distributors.
Choose the right role
Set a person's Account type first, then their role. Account type decides how they enter the app; the Management role decides what they can do.
- Brand admin (
admin/super_admin) — Full access & settings: manage users, onboarding review, settings, billing, and integrations. Super Admin adds security-sensitive administration. - Manager (
territory_manager/regional_manager) — Their territories only: scheduling, approvals, ambassador review, report review, and territory-level operations. Regional Managers oversee assigned states/markets and coordinate Territory Manager coverage. - Viewer — Read-only reports: read-only internal visibility, nothing they can change.
For Internal staff, pick one of the three cards under Management role. A user can hold several management roles — open Advanced roles — extra management roles to add more.
Set a manager's territory scope
Scope is only editable for Manager accounts. Admins always show All territories; Viewers show Read-only · all territories, and neither has an editable scope.
- Open the user from the list.
- In the scope card, click Edit scope.
- Pick a Scope type (territory, market, region, state, city, store, chain, or organization).
- Enter the Scope ID (for example a city, store ID, or chain name).
- Choose a Permission (view, schedule, approve, claim, report, or manage).
- Click Add scope, repeat for more, then click Done.
Chips are removable while editing. Any effective role or scope change forces that user's open sessions to re-authenticate.
Work the access review queue
When brand ambassadors finish onboarding, they wait for your review before they can be scheduled.
- Watch for the banner "N ambassador(s) waiting for review" above the Users list.
- Click Review to filter the list to the Ambassadors segment and In review status.
- Open an ambassador, then use Approve ambassador to activate them, or Request changes to send them back.
- If requesting changes, fill the required Change note and click Send back.
Approving activates event claiming and, when your accounting connection is on, triggers Acumatica vendor sync — the toast tells you whether the vendor synced, queued, or was skipped. An ambassador can't be approved while Longboard's platform terms are unaccepted.
Suspend or remove a user
- Deactivate: open the user and click Deactivate account — this blocks sign-in but keeps history.
- Remove: select rows and use Remove in the bulk bar, or open the user and click Remove from directory. Confirm in the "Remove N user(s) from the active list?" modal. Historical records are kept, but roles, scopes, pending invite links, and ambassador work access are cleared.
Both actions are admin-only, so Managers won't see them.
Add a distributor organization
- Open People → Distributors.
- In the Distributors card, enter the Name.
- Set Status (active, inactive, or archived) and Summary cadence (weekly, biweekly, monthly, or manual).
- Optionally set Summary lookahead (days), Primary contact email, Primary contact phone, and Notification emails.
- Add Notes if useful; use the Advanced disclosure for an External key if this distributor has an ID in an outside system.
- Click Save distributor.
To edit later, click the distributor's card in the grid — the form and its roster reload. Each card shows a Reps / Chains / Stores footer so you can see coverage at a glance.
Add distributor contacts
The contacts you add here are the distributor's org-wide summary recipients.
- Open People → Distributors.
- In the Distributor Contacts card, choose the Distributor.
- Enter Contact name, Contact email, and Role.
- Check Primary contact if this is the main recipient.
- Click Save contact.
In the Contact roster below, each contact shows a status pill — Active, Invite pending, or No account. For a contact with no account, click Create login to provision a held invite, then use Send invite to email it. You can also set a per-contact Summary cadence that overrides the org default; leave it on Inherit org default to follow the distributor's setting.
Linking a distributor to a location is not done here. A store's own distributor and contact are set per location on the Locations screen. This view manages the organization, its recipients, and bulk reassignment.
Send a distributor summary (digest)
The controls to preview and send summaries live in Brand Settings → Notifications, under Distributor Summary Controls — not on the Distributors view.
- Open Brand Settings → Notifications.
- In Distributor Summary Controls, choose one Distributor and set Window days.
- Click Preview summary and review the Distributor / Recipients / Events / Window table.
- Click Send test to me to check it in your own inbox first.
- Click Send selected summary, then confirm in the "Send this distributor summary now?" modal.
You must select exactly one distributor and preview it before sending. Only customer-safe event details are ever included. Process scheduled runs the summary queue for everything that's due.
Who can do this
- Admin / Super Admin — full control: invite and remove users, grant any role they themselves hold, run the review queue, manage distributors, and send summaries. Only Super Admin can grant Super Admin.
- Regional / Territory Managers — can operate the Users list and manage distributors, contacts, replacements, and summaries, but they're scoped to their own territories. They cannot grant elevated roles or see Deactivate account / Remove from directory (those are admin-only).
- Viewer — read-only. They can open the Users and Distributors screens and read cards and rosters, but every save, invite, and send is blocked on the backend, and the digest Process / Send buttons are hidden.
- Inviting a single user always sends the invite email — there's no opt-out. CSV staff import creates accounts but emails no one; you invite from the list afterward.
- The invite card is create-only. Reusing an email already in the system is refused with "That email address is already in use…" — open the existing user to resend or change their access instead of getting a silent update.
- If you can't find someone, set the Status filter to Archived — removed users are retained, not deleted.
- Account type controls how someone enters the app; the Management role controls what they can do. Set the account type first.
- The last Super Admin can't be removed — "At least one Super Admin is required." Keep at least two if you can.
- Distributor contacts added on the Distributors view are org-wide summary recipients; a store's own distributor and contact are set per location on the Locations screen.
- The per-contact Summary cadence control disappears entirely on plans that don't include the digest feature.
- The distributor summary won't send.
- Confirm you've selected exactly one distributor ("Select one distributor before sending a summary.") and run a preview of that distributor first ("Preview this distributor summary before sending."). If the preview flags missing recipients, no upcoming events, or no linked locations, fix those before sending.
- "Create and invite" does nothing.
- You'll see "Enter an email address first." or "Choose a primary role first." — both fields are required.
- An ambassador can't claim events after approval.
- Approval is gated behind Longboard's platform terms — a BA can't be activated until those terms are accepted. Check the approval toast for the reason.
- Approved an ambassador but no Acumatica vendor appeared.
- The success toast tells you why — it may be queued, missing fields, or the write worker is off. Confirm in Integrations → Acumatica sync jobs.
- A Viewer can't save changes.
- That's expected — Viewers are read-only, and writes are blocked on the backend even though the screens are visible.
- A Manager can't deactivate or remove someone.
- Those actions are admin-only; a Manager won't see Deactivate account or Remove from directory.
- Can't grant Super Admin.
- You can only grant an elevated role you already hold yourself;
platform_ownerisn't offered at all.
Longboard Handbook