WorkestraDocs
Getting Started

Invite Your Team

Add team members to your workspace, assign roles, and manage pending invitations.

Invite Your Team

Workestra is designed for collaboration. Invite your team members to work together in your workspace.

team members settings page

Screenshot needed � add an annotated image showing this UI

Understanding Roles

Before inviting team members, it's important to understand the five built-in roles:

RolePermissionsBest For
OwnerFull access to everything, including billing, workspace deletion, and member impersonationFounders, C-level
AdminCan manage members, roles, modules, and all settings; cannot do owner-only actionsIT admins, operations leads
ManagerOperates day-to-day across modules but only sees data for their team (walked recursively up the manager chain)Sales managers, recruiting leads, project leads
MemberCan create and edit only their own records; no delete, no export, no settingsSales reps, recruiters, individual contributors
ViewerRead-only across the workspace; no creates, edits, or deletesExecutives, auditors, clients

Members can hold multiple roles at once — effective permissions are the union of every assigned role with the most-permissive scope winning. You can also create custom roles with specific permissions and scopes, or grant ad-hoc access via the permission request workflow.

How to Invite Team Members

Step 1: Navigate to Members

  1. Click Settings in the left sidebar (or user menu).
  2. Open Administration → Members.
  3. Click the Invite Member button.

Step 2: Fill in User Details

The invitation form includes these fields:

FieldRequiredDescription
EmailYesWork email address (must be unique)
RolesYesOne or more roles. Pick a primary role and add more as needed — effective permissions are the union.

After they accept, you can configure two more things on their member row:

  • Modules — which modules they can open. New invites get every module enabled by default; revoke access per-user from the Modules popover on the Members page.
  • Manager — who they report to. Set this so team-scoped permissions resolve correctly.
add user form

Screenshot needed � add an annotated image showing this UI

Step 3: Send the Invitation

  1. Review the details
  2. Click Send Invitation
  3. The user will receive an email with a link to join

You can send multiple invitations at once. Click Add Another before sending to invite additional users.

Managing Pending Invitations

After sending invitations, you can track their status:

Viewing Pending Invites

  1. Go to Settings > Team Members
  2. Scroll to the Pending Invitations section
  3. See when each invitation was sent

Resending or Canceling

ActionHow ToWhen To Use
ResendClick the refresh icon next to a pending inviteUser didn't receive the email
CancelClick the X icon next to a pending inviteSent to wrong email, or no longer needed
RevokeClick Remove on an active userUser should no longer have access

What Happens Next

For the Invited User

  1. Receives an email with subject "You've been invited to [Workspace Name]"
  2. Clicks the Accept Invitation button
  3. Creates a Workestra account (or signs in if they already have one)
  4. Is added to the workspace with the assigned role

Invitation links expire after 7 days. If an invitation expires, simply send a new one.

For You (the Inviter)

  • Receive a notification when the user accepts
  • See the user in the Team Members list with "Active" status
  • Can modify their role or remove them anytime

Team Size Limits

Your workspace can have unlimited team members during the 14-day trial. After that:

PlanTeam Members
StarterUp to 5 users
ProfessionalUp to 25 users
EnterpriseUnlimited

When you downgrade or your trial ends, existing users beyond your plan limit will remain active, but you won't be able to add new users until you're under the limit.

Best Practices

Start with Admins

  1. Invite other admins first to help with setup
  2. Then invite team members who will use the system daily
  3. Finally, add viewers (executives, clients) once data is populated

Use Departments

Assign departments to users for:

  • Better organization in the team directory
  • Filtered views (e.g., "Show only Sales team contacts")
  • Department-specific reporting

Regular Cleanup

Periodically review your team member list:

  • Remove users who have left the company
  • Update roles as people change positions
  • Ensure the right people have access to sensitive data
  • Triage outstanding requests under Settings → Administration → Permission Requests

Troubleshooting

User Didn't Receive Invitation

  1. Ask them to check spam/junk folders
  2. Verify the email address is correct
  3. Resend the invitation
  4. If using corporate email, their IT may be blocking the email — try a personal email

User Can't Accept Invitation

  1. Check if the invitation expired (older than 7 days)
  2. Ensure they're clicking the link in the same browser session
  3. Try sending a new invitation

"Email Already in Use" Error

This means the email is already associated with a Workestra account:

  • Ask the user to sign in with their existing account
  • Then accept the workspace invitation

Next Steps

Now that your team is invited, let's choose which modules to enable: