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 roles and exactly what each can do
- 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 change your name, sign out, sign out on every other device, or delete your account.
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.
- 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 and admins can change them.
Roles
Everyone in a workspace has one role. Each role can do everything the role below it can.
| 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 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 in detail
| Action | Owner | Admin | Editor | Viewer |
|---|---|---|---|---|
| Read submissions, forms, flows and run history | Yes | Yes | Yes | Yes |
| Open uploaded files, copy JSON and export CSV | Yes | Yes | Yes | Yes |
| Create and edit forms, flows, sources and destinations | Yes | Yes | Yes | No |
| Draft forms with AI and send test submissions | Yes | Yes | Yes | No |
| Run flows again, mark spam and delete submissions | Yes | Yes | Yes | No |
| Invite people, change roles and remove members | Yes | Yes | No | No |
| Change workspace settings | Yes | Yes | No | No |
| Create and revoke API keys | Yes | Yes | No | No |
| Change the plan, the card and see invoices | Yes | Yes | No | No |
| Hand the workspace to someone else | Yes | No | No | No |
| Delete the workspace | Yes | No | No | No |
Invite people
- 01
Open Members
Open Members from the workspace menu and choose Invite people. You need to be an owner or admin. - 02
Enter an email and pick a role
Invite one person at a time. The role starts as Editor; choose Admin or Viewer instead if that fits better. - 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 |
| Enterprise | Unlimited team members |
Change roles, hand over or leave
- Change a role: owners and admins pick a new role next to a person on the Members page. Nobody can change their own role.
- 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: owners and admins 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. |
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 either read only, or has full access, which can also create, change and delete. See Access levels.
- Owners and admins 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.