Workspaces & Teams

Workspaces

Workspaces provide isolated environments for managing multiple clients or projects. Each workspace has its own campaigns, lists, senders, domains, and analytics.

Creating a Workspace

  1. Go to Workspaces → New Workspace (admin only)
  2. Enter a name, domain, and optional email
  3. A URL-safe slug is auto-generated from the name
  4. Optionally assign to a team member

Workspace Scoping

All data is scoped to workspaces. When you select a workspace (via header X-Workspace-ID or query param), all API calls return only data belonging to that workspace.

  • Admins can see all workspaces and switch between them
  • Members only see workspaces assigned to them

Client Portal

Each workspace has a shareable public portal that shows campaign stats to clients without giving them dashboard access:

  1. Go to workspace settings
  2. Click Generate Share Token
  3. Share the portal URL with your client

The portal shows: emails sent, open rate, bounce rate, unsubscribe rate, domain/sender counts, and campaign list.

White-label portal

Customize the portal's primary color per workspace to match your client's brand.

Workspace Properties

PropertyDescription
NameDisplay name
SlugURL identifier (auto-generated, unique)
DomainClient's primary domain
Tracking DomainCustom domain for open/click tracking URLs
Share TokenPublic portal access token
Assigned ToTeam member responsible for this workspace
Portal ColorPrimary color for the client portal