Tectra
Guides

Managing Teams

Learn how to create and manage teams in Tectra

Managing Teams

Teams allow you to organize your workspace into separate environments for different groups within your organization. Each team has its own workflows, integrations, and resources, making it easy to collaborate while keeping work organized.

What are Teams?

Teams are isolated workspaces within your organization that allow you to:

  • Organize by department - Create separate teams for Engineering, Sales, Marketing, etc.
  • Isolate resources - Each team has its own workflows, meetings, and integrations
  • Control access - Team members only see resources in their teams
  • Maintain privacy - Team data is kept separate from other teams
  • Share organization resources - Access organization-wide resources when needed

Teams vs. Organization

Understanding the difference between team-scoped and organization-scoped resources:

AspectOrganization-ScopedTeam-Scoped
VisibilityAll users in organizationOnly team members
ResourcesShared workflows, integrationsTeam-specific resources
Use CaseCompany-wide toolsDepartment-specific work
AccessAll organization membersTeam members only

Creating a Team

From the Teams Page

  1. Navigate to SettingsTeams in the sidebar
  2. Click the Create Team button
  3. Enter team details:
    • Name: Choose a descriptive name (e.g., "Engineering", "Sales Team")
    • Description: Optional description of the team's purpose
  4. Click Create

Your new team is now created! You'll be automatically added as the first member.

Team Creation Best Practices

  • Use clear names - Make it obvious what the team is for
  • Add descriptions - Help members understand the team's purpose
  • Plan structure - Think about how many teams you need before creating them
  • Start small - Create a few key teams first, add more as needed

Managing Team Members

Adding Members to a Team

  1. Go to SettingsTeams
  2. Click on the team you want to manage
  3. Click Add Member
  4. Select users from your organization
  5. Choose their role (Member or Admin)
  6. Click Add

Team Roles

  • Admin: Can manage team settings, add/remove members, and manage resources
  • Member: Can create and manage resources within the team

Removing Members

  1. Navigate to the team
  2. Find the member in the members list
  3. Click the Remove button next to their name
  4. Confirm the removal

Note: Removing a member from a team doesn't delete their account or remove them from the organization.


Switching Between Teams

Using the Team Selector

The team selector appears in the top navigation bar:

  1. Click the team dropdown in the header
  2. Select the team you want to switch to
  3. The page will refresh and show that team's resources

Organization View

To see organization-wide resources:

  1. Click the team dropdown
  2. Select Organization (or deselect the current team)
  3. You'll now see resources shared across all teams

Dashboard Changes

When you switch teams, the dashboard shows:

  • Team-specific key metrics
  • Recent activity for that team
  • Quick actions scoped to the team

Creating Team-Scoped Resources

Workflows

When creating a workflow:

  1. Click Create Workflow
  2. The workflow will automatically be assigned to your current active team
  3. Only team members can see and edit this workflow

To create an organization-wide workflow:

  • Switch to Organization view before creating

Integrations

Integrations can be scoped to teams:

  1. Switch to the desired team
  2. Go to Integrations
  3. Connect a new integration
  4. The OAuth connection is saved to the team

Why team-scoped integrations?

  • Different API keys per team
  • Separate Slack channels per team
  • Isolated credentials for security

Meetings

Meetings are automatically team-scoped:

  1. Schedule a meeting while a team is active
  2. Meeting notes and transcripts are only visible to team members
  3. Action items created from the meeting are team-scoped

Finding Team Resources

Filtering by Team

Use the team selector to filter:

  • Workflows - See only workflows for the selected team
  • Integrations - View team-specific connections
  • Meetings - See team meetings only

The search bar respects your current team selection:

  • Searching while a team is active shows results from that team
  • Switch to Organization view to search across all teams

Understanding Team Permissions

What Team Members Can Do

Team members can:

  • ✅ Create workflows within the team
  • ✅ Connect integrations for the team
  • ✅ Schedule meetings and create entities
  • ✅ Execute workflows within the team
  • ✅ View team dashboard and metrics

Team members cannot:

  • ❌ See resources from other teams
  • ❌ Add or remove team members (unless Admin)
  • ❌ Archive the team
  • ❌ Access organization settings

Organization Admin vs Team Admin

PermissionOrganization AdminTeam AdminTeam Member
Create teams
Archive teams
Manage team members
Team settings
Create resources
View billing

Team Dashboard & Metrics

Each team has its own dashboard showing:

Key Metrics

  • Active Workflows - Workflows created in this team
  • Meetings Processed - Meetings held by team members
  • Tasks Created - Workflow executions and action items
  • Integrations - Connected apps for this team

Recent Activity

  • Workflow executions
  • Meetings created
  • Integrations added
  • Team member activity

Archiving a Team

Only organization admins can archive teams. Tectra uses soft deletion - archived teams are not permanently deleted, but become inactive.

What Happens When You Archive a Team

  • Team becomes inactive - The team moves to the "Archive" tab
  • Resources are preserved - All workflows, integrations, and data remain intact
  • AI Assistant access disabled - Team resources won't be accessible in meetings, Slack, or other interfaces
  • Members remain - Users stay in the organization
  • Can be restored - Archived teams can be unarchived at any time

How to Archive

  1. Go to SettingsTeams
  2. Click on the team you want to archive
  3. Click Archive Team
  4. Confirm the action
  5. The team will move to the Archive tab

Viewing Archived Teams

  1. Go to SettingsTeams
  2. Click the Archive tab
  3. You'll see all archived teams

Restoring an Archived Team

  1. Go to SettingsTeamsArchive tab
  2. Click on the archived team
  3. Click Restore Team
  4. The team will return to the active Teams tab

Note: Restoring a team makes it active again, and all resources become accessible through the AI assistant and other interfaces.


Common Workflows

Setting Up Department Teams

  1. Create teams for each department:

    • Engineering
    • Sales
    • Marketing
    • Customer Success
  2. Add members to their respective teams

  3. Connect team-specific integrations:

    • Engineering: GitHub, Jira
    • Sales: Salesforce, HubSpot
    • Marketing: Mailchimp, Google Analytics
  4. Create team-specific workflows

Project-Based Teams

  1. Create a team for each project
  2. Add cross-functional members
  3. Set up project-specific integrations
  4. Create workflows for project automation
  5. Archive the team when the project completes

Client-Specific Teams

  1. Create a team per client
  2. Add account managers and support staff
  3. Connect client-specific tools
  4. Maintain separate meeting histories
  5. Keep client data isolated

Tips & Best Practices

Organization Structure

  • Keep it simple - Don't create too many teams
  • Clear naming - Use consistent naming conventions
  • Regular review - Audit teams quarterly
  • Archive unused teams - Archive teams that are no longer active

Access Management

  • Least privilege - Only give team admin to those who need it
  • Regular audits - Review team membership monthly
  • Onboarding - Add new employees to appropriate teams
  • Offboarding - Remove departing employees from all teams

Resource Organization

  • Default to organization - Only use teams when you need isolation
  • Shared workflows - Keep common workflows at organization level
  • Team-specific tools - Use team integrations for isolated credentials
  • Documentation - Document team purposes and workflows

Troubleshooting

I can't see a workflow I created

Solution: You may have created it while a different team was active. Switch to the correct team or Organization view.

Integration isn't working in my team

Solution: Integrations are team-scoped. Reconnect the integration while the correct team is active.

I can't add a member to a team

Possible causes:

  • You need to be a Team Admin or Organization Admin
  • The user hasn't accepted their organization invitation yet
  • The user is already a member of the team

Team dashboard shows zero metrics

Solution: Metrics are calculated for team-scoped resources only. If you just created the team, it's normal to see zeros until you create resources.

Can't archive a team

Solution: Only Organization Admins can archive teams. Contact your admin if you need a team archived.


FAQ

How many teams can I create?

There's no limit on the number of teams. However, we recommend keeping your structure simple with fewer, well-organized teams.

Can a user be in multiple teams?

Yes! Users can be members of multiple teams and switch between them easily.

Do teams cost extra?

No, teams are included in all Tectra plans at no additional cost.

Can teams see each other's data?

No, team resources are isolated. Only organization admins can see all data.

What happens to resources when a team is archived?

Resources remain with the team but become inaccessible through the AI assistant in meetings, Slack, and other interfaces. The team can be restored at any time to make resources active again.

Can I move resources between teams?

Yes, you can edit a resource and change its team assignment. Organization admins can move resources between any teams.

Are meetings automatically team-scoped?

Yes, when you schedule a meeting with a team active, it's automatically scoped to that team.