# Workspaces and team

A workspace holds forms, flows, submissions, destinations and API keys, and the people who work on them. You can belong to several workspaces and switch between them.

**On this page you will learn**

- How signing in works without a password
- What a workspace is, and how to switch or create one
- The four default roles, roles of your own, and the permissions behind them
- How to invite people, and how seats are counted
- How to change roles, hand over a workspace or leave it
- How API keys work

## Signing in

1. **Enter your email**

   On the [sign-in page](https://formpik.com/login), type your email address. There is no password to remember.
2. **Open the email**

   Formpik sends a sign-in button and a 6-digit code. Click the button, or type the code on the sign-in page, which is handy when the email is on your phone. Both work once and for 15 minutes.
3. **You are in**

   The first time, your account is created and you name your first workspace, or join one you were invited to. Your session lasts 30 days and renews while you use the app.

From your account page you can upload a profile photo (or go back to the default avatar, a pattern drawn from your account), change your name, change the email you sign in with, sign out, sign out on every other device, or delete your account. A new email address only takes effect once you enter the code sent to it, or click the button in that email, and your old address gets a notice that it changed.

## Workspaces

A workspace is one team's space: its forms, sources, flows, destinations, submissions, API keys, members and plan. Nothing is shared between workspaces. An agency might keep one workspace per client, so each client's data, team and billing stay apart.

- Switch workspaces, or create a new one, from the workspace menu at the top of the sidebar.
- Everyone gets **one free workspace**. Every other workspace you own needs Pro or Max: you pick the plan when you create it and pay on the next step. Workspaces other people invite you to never count.
- An extra workspace without a paid plan is **locked**: only Plan and billing, Settings and Members stay open, its forms refuse submissions and its API keys stop working. Nothing is deleted, and choosing a plan opens it again. This happens when its payment was never finished, or when its plan ends while your free workspace is in use. Deleting your free workspace, or handing it to someone else, makes the next one free.
- You can hand a free workspace only to someone who has not used their free workspace yet. A paid workspace can go to anyone.
- The same menu links to the workspace pages: Settings, Members, Plan and billing, and API keys.
- Settings holds the workspace name and timezone, the **Delivery problems** email to owners and admins, **Anonymize IP addresses** (on by default) and the retention for new forms. Owners, admins and roles with the Settings permission can change them.

## Roles

Everyone in a workspace has one role, and every role reads the whole workspace: forms, flows, submissions and run history. A role is a set of permissions, and each permission lets someone change one part of the workspace. Every workspace has four default roles, which never change, and can add roles of its own built from the same permissions.

### Default roles

| Role | In short | Can do |
| --- | --- | --- |
| Owner | Full control of the workspace | Everything an admin can do. Hand the workspace to someone else. Delete the workspace. |
| Admin | Runs the workspace and the team | Invite people, create roles and change roles. Manage the plan and billing. Change settings and API keys. Everything an editor can do. |
| Editor | Builds and runs the pipeline | Create and edit forms, flows, sources and destinations. Work the inbox and rerun submissions. |
| Viewer | Follows along without changing anything | Read submissions, forms and flows. See the overview and run history. |

### Permissions

The owner has every permission and is the only one who can hand the workspace over or delete it. The other default roles have these:

| Permission | What it allows | Admin | Editor | Viewer |
| --- | --- | --- | --- | --- |
| **Forms** `forms.manage` | Create, change and delete forms, and draft them with AI. | `Yes` | `Yes` | `No` |
| **Flows** `flows.manage` | Create, change, test and delete flows. | `Yes` | `Yes` | `No` |
| **Sources** `sources.manage` | Connect websites, give them a new endpoint address and remove them. | `Yes` | `Yes` | `No` |
| **Destinations** `destinations.manage` | Connect, change and disconnect chat channels and webhooks. | `Yes` | `Yes` | `No` |
| **Webhook secrets** `destinations.secrets` | See the full address and signing secret of every destination. | `Yes` | `No` | `No` |
| **Inbox** `submissions.manage` | Mark spam, release, run flows again, delete and send test submissions. | `Yes` | `Yes` | `No` |
| **Team** `members.manage` | Invite people, resend and withdraw invitations, and remove members. | `Yes` | `No` | `No` |
| **Roles** `roles.manage` | Create, change and delete roles, and change the role of each person. | `Yes` | `No` | `No` |
| **Settings** `settings.manage` | Change the workspace name, timezone, notifications and privacy settings. | `Yes` | `No` | `No` |
| **Billing** `billing.manage` | Change the plan and the card, and see invoices. | `Yes` | `No` | `No` |
| **API keys and apps** `api_keys.manage` | Create and revoke API keys, and see and disconnect every connected app. | `Yes` | `No` | `No` |

### Roles of your own

Make a role when none of the default ones fits, such as Support for someone who only works the inbox, or Billing for whoever pays, without letting them change forms.

1. **Open the Roles tab**

   Open Members from the workspace menu and choose the **Roles** tab. You need the Roles permission, which owners and admins have.
2. **Create the role**

   Choose **New role**, give it a name and a line about what it is for, and tick its permissions. **Start from** copies the permissions of another role, and the copy button on a default role does the same.
3. **Give it to people**

   Pick it next to anyone on the **People** tab, or when you invite someone. A change to the role reaches everyone who has it straight away.

- **Nobody gives more than they have.** You can only tick permissions your own role has, and only give people roles made of them.
- **Nobody acts on someone with more access.** To change someone's role, remove them or withdraw their invitation, your role needs every permission theirs has.
- **Deleting a role** moves everyone who has it, and every open invitation with it, to the role you pick (Viewer unless you choose another). Nobody leaves the team.
- A workspace can have up to 50 roles of its own. Each needs its own name, and the names of the default roles are taken.
- Roles work the same through the [API](https://formpik.com/docs/api) and for [AI agents](https://formpik.com/docs/mcp): they can list permissions, roles and members, create, change and delete roles, and give someone a role.

> **One owner per workspace**
>
> Every workspace has exactly one owner, the person who created it unless they handed it over. The owner cannot be removed and their role cannot be changed by anyone else.

## Invite people

1. **Open Members**

   Open Members from the workspace menu and choose **Invite people**. You need the Team permission, which owners and admins have.
2. **Enter an email and pick a role**

   Invite one person at a time. The role starts as Editor; choose any default role or one of your own instead. Roles with permissions your own role lacks cannot be picked.
3. **They get an email**

   The invitation link works for 7 days. They open it, sign in with the address you invited if they are not signed in yet, and accept or decline. Someone who signs in for the first time also finds open invitations on their welcome page.

- Open invitations count toward your plan's team seats until they are accepted, withdrawn or expire. When the seats are full, new invitations are refused until you upgrade or free a seat.
- **Resend** emails a fresh link that works for another 7 days. The previous link stops working.
- **Withdraw** cancels an invitation, so its link stops working and its seat is free again.
- Each person can send up to 10 invitations a day.
- If the plan went down after an invitation was sent and the team is full, the invitation cannot be accepted until a seat is free.

| Plan | Team seats |
| --- | --- |
| Starter | 2 team members |
| Pro | 10 team members |
| Max | Unlimited team members |

## Change roles, hand over or leave

- **Change a role**: anyone with the Roles permission picks a new role next to a person on the Members page. Nobody can change their own role or the owner's.
- **Make owner**: only the owner can hand the workspace to someone else. The new owner gets full control and the previous owner becomes an admin.
- **Remove from workspace**: anyone with the Team permission can remove anyone except the owner. That person loses access right away.
- **Leave workspace**: anyone except the owner can leave. As the owner, make someone else the owner first, or delete the workspace.

### Example: an agency team

A studio with three client sites sets up its workspace like this:

| Person | Role | Why |
| --- | --- | --- |
| The founder | Owner | Created the workspace and pays for it. |
| The operations lead | Admin | Invites freelancers, manages billing and the API key the studio uses. |
| Two developers | Editor | Build forms and flows, and fix failed deliveries. |
| A client contact | Viewer | Reads their own submissions without changing anything. |
| A part-time assistant | Support (their own role) | Has only the Inbox permission: marks spam and runs flows again, but never touches forms or flows. |

## API keys

API keys let your own code work with your workspace through the [API](https://formpik.com/docs/api), and send submissions to the endpoint without the allowed websites check and the bot check. A key is read only, has full access, which can also create, change, publish and delete, or has admin access, which can also manage the team, API keys, workspace settings and billing. See [Access levels](https://formpik.com/docs/api#access).

- Owners, admins and roles with the API keys and apps permission create keys on the API keys page. Give each one a name that says where it is used.
- A key is shown once, right after you create it, so copy it straight away. Formpik only keeps a hash and cannot show it again.
- The page shows when each key was last used. Revoke a key there when you no longer need it, or if it may have leaked.
- A key belongs to one workspace and only works there. The number of keys depends on your plan.

> **Keep keys on your server**
>
> Never put an API key in a web page or a mobile app. Anyone who finds it can read every submission of the workspace, a full access key can also change it, and an admin key can also invite people and change the plan.

## Delete a workspace or your account

The owner can delete a workspace from the danger zone in Settings by typing its name. A paid plan is canceled first, so the card is not charged again. If payments cannot be reached at that moment, the workspace is not deleted, so you are never left paying for a workspace that is gone.

You can delete your account from your account page by typing your email. You are signed out everywhere and removed from every team, and workspaces where you are the only member are deleted. If you own a workspace other people still use, make one of them the owner first.

## Questions

### I did not get the sign-in email. What now?

Check your spam folder and wait a minute. You can ask for a new email, but only a few per address every 15 minutes and per day, so try the newest email first.

### Can I invite someone who already has a Formpik account?

Yes. They open the link in the email while signed in with the invited address and accept. The workspace is added to their workspace menu and opens right away.

### Someone accepted with a different email. Why does it not work?

An invitation only works for the address it was sent to. Withdraw it and invite the address they sign in with.

### Does a viewer take a seat?

Yes. Every member counts toward team seats, whatever their role, and so does every open invitation.

### Can I change what Editor can do?

No, the default roles never change. Copy Editor on the Roles tab, change the copy, and give it to the people who need it.

### Can a role hide submissions from someone?

No. Every role reads the whole workspace, submissions included. Permissions only decide what someone can change.

## Next steps

- [Plans and limits](https://formpik.com/docs/plans): Team seats and everything else per plan.
- [API overview](https://formpik.com/docs/api): Use your API key to read submissions.
- [Spam, privacy and security](https://formpik.com/docs/security): How sign-in, sessions and keys are protected.
- [Submissions inbox](https://formpik.com/docs/submissions): What your team works with every day.

---

Source: https://formpik.com/docs/team
