Run your workspace
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
- 01
Enter your email
On the sign-in page, type your email address. There is no password to remember. - 02
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. - 03
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.
- 01
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. - 02
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. - 03
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 and for AI agents: they can list permissions, roles and members, create, change and delete roles, and give someone a role.
Invite people
- 01
Open Members
Open Members from the workspace menu and choose Invite people. You need the Team permission, which owners and admins have. - 02
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. - 03
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, 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.
- 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.
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.