Skip to content

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

  1. 01

    Enter your email

    On the sign-in page, type your email address. There is no password to remember.
  2. 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.
  3. 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.

RoleIn shortCan do
OwnerFull control of the workspaceEverything an admin can do. Hand the workspace to someone else. Delete the workspace.
AdminRuns the workspace and the teamInvite people and change roles. Manage the plan and billing. Change settings and API keys. Everything an editor can do.
EditorBuilds and runs the pipelineCreate and edit forms, flows, sources and destinations. Work the inbox and rerun submissions.
ViewerFollows along without changing anythingRead submissions, forms and flows. See the overview and run history.

Permissions in detail

ActionOwnerAdminEditorViewer
Read submissions, forms, flows and run historyYesYesYesYes
Open uploaded files, copy JSON and export CSVYesYesYesYes
Create and edit forms, flows, sources and destinationsYesYesYesNo
Draft forms with AI and send test submissionsYesYesYesNo
Run flows again, mark spam and delete submissionsYesYesYesNo
Invite people, change roles and remove membersYesYesNoNo
Change workspace settingsYesYesNoNo
Create and revoke API keysYesYesNoNo
Change the plan, the card and see invoicesYesYesNoNo
Hand the workspace to someone elseYesNoNoNo
Delete the workspaceYesNoNoNo

Invite people

  1. 01

    Open Members

    Open Members from the workspace menu and choose Invite people. You need to be an owner or admin.
  2. 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.
  3. 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.
PlanTeam seats
Starter2 team members
Pro10 team members
EnterpriseUnlimited 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:

PersonRoleWhy
The founderOwnerCreated the workspace and pays for it.
The operations leadAdminInvites freelancers, manages billing and the API key the studio uses.
Two developersEditorBuild forms and flows, and fix failed deliveries.
A client contactViewerReads 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.

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.

Next steps