Skip to main content

​
What Are Workspaces?

Workspaces (also called organizations) are isolated environments for managing email sending. They’re perfect for:

Multiple Projects

Keep production and staging separate

Team Collaboration

Invite developers, marketers, and admins

Access Control

Assign different permission levels

Separate Billing

Each workspace can have its own plan

​
Creating a Workspace

1

Open Workspace Switcher

Click on your current workspace name in the top-left of the dashboard to open the switcher.
2

Create New Workspace

Click the “Create Workspace” button and enter a name for your new workspace.
Use descriptive names like “Production”, “Marketing”, or your project name.
3

Set Up Your Workspace

After creation, add your domains, create API keys, and invite team members.

​
Create via API

You can also create workspaces programmatically:
cURL
curl -X POST https://www.unosend.co/api/v1/workspaces \
  -H "Authorization: Bearer un_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production"
  }'

​
Inviting Team Members

​
From Dashboard

  1. Go to Settings → Team in your workspace
  2. Click “Invite Member”
  3. Enter their email address and select a role
  4. They’ll receive an email invitation to join

​
Via API

cURL
curl -X POST https://www.unosend.co/api/v1/members \
  -H "Authorization: Bearer un_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "teammate@example.com",
    "workspaceId": "org_abc123",
    "role": "admin"
  }'

​
Roles & Permissions

Each team member is assigned a role that determines their access level:
RoleCan DoCannot Do
OwnerEverything—
AdminManage domains, API keys, members, settingsDelete workspace, manage billing, transfer ownership
MemberSend emails, view logs, access dashboardManage settings, invite members, create API keys

​
Switching Workspaces

If you belong to multiple workspaces, you can switch between them:
1

Click workspace name

Click on the workspace name in the top-left corner of the dashboard
2

Select workspace

Select the workspace you want to switch to from the dropdown
3

Dashboard reloads

The dashboard will reload with the selected workspace’s data

​
API Keys per Workspace

Each workspace has its own set of API keys. This means:
  • API keys from one workspace cannot access another workspace’s data
  • You can have different keys for production vs development workspaces
  • Revoking a key only affects that specific workspace
When switching workspaces in the dashboard, make sure you’re copying the correct API key for your environment.

​
Best Practices

  • ✓ Separate production and development - Create separate workspaces to avoid sending test emails through production.
  • ✓ Use descriptive names - Name workspaces clearly so team members know which to use.
  • ✓ Limit admin access - Only grant admin roles to those who need to manage settings and keys.
  • ✓ Review members regularly - Remove access for team members who no longer need it.