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 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. 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 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

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, create roles 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

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:

PermissionWhat it allowsAdminEditorViewer
Forms forms.manageCreate, change and delete forms, and draft them with AI.YesYesNo
Flows flows.manageCreate, change, test and delete flows.YesYesNo
Sources sources.manageConnect websites, give them a new endpoint address and remove them.YesYesNo
Destinations destinations.manageConnect, change and disconnect chat channels and webhooks.YesYesNo
Webhook secrets destinations.secretsSee the full address and signing secret of every destination.YesNoNo
Inbox submissions.manageMark spam, release, run flows again, delete and send test submissions.YesYesNo
Team members.manageInvite people, resend and withdraw invitations, and remove members.YesNoNo
Roles roles.manageCreate, change and delete roles, and change the role of each person.YesNoNo
Settings settings.manageChange the workspace name, timezone, notifications and privacy settings.YesNoNo
Billing billing.manageChange the plan and the card, and see invoices.YesNoNo
API keys and apps api_keys.manageCreate and revoke API keys, and see and disconnect every connected app.YesNoNo

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. 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.
  2. 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.
  3. 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

  1. 01

    Open Members

    Open Members from the workspace menu and choose Invite people. You need the Team permission, which owners and admins have.
  2. 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.
  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
MaxUnlimited 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:

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.
A part-time assistantSupport (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.

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