Workspaces

A workspace holds everything for one brand. If you send email for more than one shop, club or company from the same installation, give each one its own workspace. People in one workspace never see the contacts, campaigns or settings of another.

What belongs to a workspace

Each workspace has its own:

  • audiences, contacts, tags, segments, custom fields, interest groups and imports
  • the suppression list and the inactive cleanup settings
  • campaigns, A/B tests, RSS campaigns, folders, comments and reports
  • templates, saved sections and uploaded images
  • landing pages and signup forms
  • automations and journeys
  • sending provider, company name and address, brand kit, report emails and approval setting
  • sending domains, from addresses and the tracking domain
  • integrations, outgoing webhooks, online stores, text message, social, ad and postcard accounts
  • API keys
  • team, with a role for each person
  • audit log entries

These are shared by the whole installation: logging in, two-factor and single sign-on settings, how long the audit log keeps entries, the default theme and language, the GeoIP file, the AI assistant key and the help center.

Only installation admins change the shared settings and the help center articles. They are the Owners of the first workspace, and the person who set up SendKettle. An Admin or Owner of another workspace doesn't see the Security and AI assistant tabs, the default theme and language or the GeoIP file. Every change to a shared setting is written to the audit log with its old and new value (for keys and secrets only that they changed). Installation admins see these entries.

On a hosted SendKettle (the cloud edition) several customers share one installation. Each customer has an account with its own people and workspaces, and the shared settings above belong to that account: the Owners of the account's first workspace change them. The GeoIP file, the push notification keys and the help center are run by the people who host SendKettle. People only ever see workspaces of their own account, and you can only invite people who have no login yet or who already belong to your account. On your own server you have one account, so nothing changes.

Your first workspace holds everything that was there before workspaces existed. It is named after your company name, or "Main workspace" when you had none.

Switch to another workspace

The name of the workspace you are in is shown at the top of the sidebar, under the logo. In the narrow Bento Rail menu you only see its first letter.

  1. Click the workspace name (or letter) in the sidebar.
  2. Click the workspace you want to open.

You go to the dashboard of that workspace. The list only shows the workspaces you are a member of.

Create a workspace

You need the Owner role in the workspace you are in.

  1. Click your name at the bottom of the menu, then Settings.
  2. Click the Account section, then Workspaces.
  3. In the New workspace box, fill in Name.
  4. Click Create workspace.

The new workspace starts empty and you are its Owner. You are taken straight to it. Next:

  1. Connect a sending provider under Settings, on the Sending and company tab. Each workspace sends through its own provider. Until you add one, its emails use the MAIL_ settings in .env. Out of the box those only write to the server log; in local development they often point at a mail catcher such as Mailpit.
  2. Fill in the company name and address for the footer of its emails.
  3. Invite the people who work on this brand under Users.

Rename a workspace

You need the Admin or Owner role.

  1. Switch to the workspace you want to rename.
  2. Click your name at the bottom of the menu, then Settings, then Account, Workspaces.
  3. Change Name in the This workspace box.
  4. Click Rename workspace.

Delete a workspace

You need the Owner role. Only an empty workspace can go: delete its audiences, campaigns, templates, landing pages and automations first. The first workspace can't be deleted, because it holds the shared settings.

  1. Switch to the workspace you want to delete.
  2. Click your name at the bottom of the menu, then Settings, then Account, Workspaces.
  3. Click Delete workspace and confirm.

Its settings are removed and nobody can open it anymore. Accounts stay. Someone who was in no other workspace can't use the app until an Admin invites them to another one.

To close a workspace that still has contacts and campaigns, use Close this workspace on the Data tab. It deletes everything after a full export and a grace period of 14 days. See Your data, limits and closing a workspace, which also explains usage limits per workspace.

People and roles

A person has one account and a role in each workspace they belong to. Someone can be Owner of one workspace and Viewer of another. What the role allows is the same everywhere; see Team and roles.

Add someone to a workspace

  1. Switch to the workspace.
  2. Click your name at the bottom of the menu, then Users.
  3. Fill in Name, Email and Role in the Invite a user box.
  4. Click Send invitation.

If the email address already has an account, that person gets an email with a link to join this workspace. They join, with the role you chose, only after they open the link while signed in with their own account and click Join; the link works for 7 days. Until then they are not on the team and you don't see their name. Otherwise they get the usual invitation email. Either way you see the same message, so the form doesn't tell you whether an address already has an account.

Remove someone from a workspace

  1. Switch to the workspace.
  2. Click your name at the bottom of the menu, then Users.
  3. Click Remove next to the person and confirm.

They lose access to this workspace only. When it was their last workspace, the account is deleted, as before.

People who log in for the first time through single sign-on join the first workspace with the default role from the security settings.

API keys

An API key belongs to the workspace you were in when you created it, and only reaches that workspace. It acts with your role in that workspace. Your profile lists the keys of the current workspace. When you leave a workspace, its keys and the Zapier subscriptions made with them are deleted, so they don't come back if you are invited again.

Signup forms, landing pages, unsubscribe and preference links, web versions, the email archive and tracking links have no workspace in their address. They keep working exactly as before: each link belongs to the workspace of the list, email or page it points to.

Webhooks from providers

Bounce webhooks, Stripe, Facebook Lead Ads, Shopify, WooCommerce, Twilio and MessageBird all send to the same addresses for every workspace. SendKettle checks the secret or signature against each workspace's saved settings and handles the message in the workspace it matches. Give each workspace its own webhook secret (under Settings) and its own provider keys. Workspaces may share one Twilio or MessageBird account: a STOP or START reply then counts for the workspace whose sender number it was sent to, or for all of them when none uses that number, and delivery reports reach the workspace that sent the message. Requests with a wrong secret or signature are refused; after many of them from one address, that address is refused for a minute on that webhook only, so real deliveries keep coming in.

Common problems

I don't see the Workspaces tab

The tab needs the Admin or Owner role in the workspace you are in. Creating and deleting workspaces needs the Owner role.

A colleague can't find a campaign I made

They are probably in another workspace. Ask them to check the name at the top of the sidebar and switch.

"Your account is not part of any workspace"

Every workspace you were in was deleted. Ask an Admin to invite you to a workspace with your email address.