> ## Documentation Index
> Fetch the complete documentation index at: https://dashtray.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Team Collaboration

> Work together with your team on Dashtray

## Overview

Teams let you collaborate with teammates on shared notification alerts and access.

**Creating teams:** Pro plan only (1 team included, \$30 per extra team/month). **Joining teams:** available on all plans — Starter users can join via invite code or owner approval at no extra cost.

## Creating a Team

### Step 1: Create Team

1. Open Dashtray app
2. Go to Settings
3. Tap "Teams"
4. Tap "Create Team"
5. Enter team name
6. Choose team color
7. Tap "Create"

Your team is created! You're automatically the owner.

### Step 2: Share with Teammates

1. Go to your team in Teams section
2. Tap "Invite Members"
3. Enter teammate's email
4. Tap "Send Invite"
5. They receive email with join link
6. Once accepted, they're added to team

### Step 3: Create Team Alerts

1. Go to Alerts
2. Tap **Create with AI** or **Create Manually**
3. In the team picker, select your team (or leave it on "Personal")
4. Finish creating the alert
5. All team members can now see it in the team's page

## Team Roles

### Owner

Team creator with full control:

* ✅ Create team alerts
* ✅ Invite/remove members
* ✅ Delete team
* ✅ Edit team settings
* ✅ View all notifications

### Member

Team members can:

* ✅ Create team alerts
* ✅ Edit team alerts
* ✅ View team notifications
* ✅ See team activity
* ❌ Cannot remove members
* ❌ Cannot delete team

## Inviting Teammates

### Send Invitation

1. Team settings
2. "Invite Members"
3. Enter email address
4. Tap "Send"

They receive email with:

* Team name
* Join link
* Your name as inviter

### Invitation Link

Shares a public link for easier joining:

1. Team settings
2. "Invite Link"
3. Share the link
4. Teammates tap to join

Invitations expire after 7 days.

### Pending Invitations

See who you've invited:

1. Team settings
2. "Pending Invites"
3. Shows email, date sent
4. Can resend or cancel

## Team Alerts

### Personal vs Team Alerts

**Personal Alert:**

* Only you see/use
* Private notifications

**Team Alert:**

* Listed on the team's page for all members
* One webhook URL shared by the team
* Everyone on the team gets the same notifications

### Create Team Alert

1. Open Alerts
2. Tap **Create with AI** or **Create Manually**
3. Pick the team from the team picker (chips below the form)
4. Finish creating
5. The alert appears on the team's page

Members can:

* See the alert and its notifications
* Edit the template

### Shared Webhook URL

Team alerts have one webhook URL:

```
https://dashtray.app/p/{short_code}
```

**All team members:**

* See the URL
* Can paste into services
* Receive the same notifications

### Team Notification History

Team members see:

* All team alert notifications
* Shared history

Personal alerts only show to their owner.

## Managing Teammates

### View Team Members

1. Go to Teams
2. Select team
3. See all members
4. Shows join date and role

### Remove Member

⚠️ **Warning:** Cannot be undone

1. Team settings
2. Find member
3. Tap "Remove"
4. Confirm

They immediately:

* Lose access to team alerts
* Cannot see team notifications
* Can still use personal alerts

### Leave Team

1. Go to Teams
2. Select team
3. Tap "Leave Team"
4. Confirm

You:

* Lose access to team alerts
* Keep your personal alerts
* Can rejoin if invited again

## Team Settings

### Edit Team

1. Go to Teams
2. Select team
3. Tap "Edit"
4. Change:
   * Team name
   * Team color
5. Save

### Team Information

View:

* Team name
* Created date
* Number of members
* Team color
* Invite code

## Sharing Alerts

### Collaboration Workflow

**Scenario: Setting up Stripe notifications**

1. **Owner** creates "Stripe Payments" alert
2. **Owner** gets webhook URL from Dashtray
3. **Owner** adds webhook to Stripe dashboard
4. **Members** see alert in app
5. **Members** can view notifications
6. **Members** can edit template if needed
7. **Everyone** sees same notifications

## Best Practices

### Team Organization

✅ **Do:**

* Use descriptive alert names
* Color-code by type (payments, deployments, etc.)
* Include team members' names in important alerts
* Document what each alert does

❌ **Don't:**

* Create duplicate alerts
* Leave old unused alerts active
* Share passwords/secrets in alert names

### Communication

✅ **Do:**

* Notify team when creating important alerts
* Document template variables
* Share webhook URLs securely
* Communicate outages/issues

❌ **Don't:**

* Send webhook URLs over insecure channels
* Share production secrets
* Change active alerts without notifying team

### Permissions

✅ **Do:**

* Only invite who needs access
* Remove team members when they leave
* Use appropriate roles
* Audit team regularly

❌ **Don't:**

* Share team access widely
* Leave old members with access
* Give unnecessary permissions

## Use Cases

### Development Team

Setup:

* Backend deployments alert
* CI/CD pipeline alert
* Error monitoring alert
* All shared with team

Result: Entire team notified of builds, deployments, errors

### Startup Team

Setup:

* New customers alert
* Payment received alert
* Subscription changes alert
* Support tickets alert

Result: Team always knows what's happening

### Support Team

Setup:

* High-priority tickets alert
* Customer feedback alert
* System status alert
* SLA warnings alert

Result: Support team responds faster

### Multi-Department Company

Setup:

* Sales team: New leads, deals
* Engineering: Deployments, errors
* Finance: Payments, invoices
* Ops: Infrastructure alerts

Result: Each department gets relevant alerts

## Troubleshooting

### Can't invite member

**Check:**

1. You're team owner
2. Member email is correct
3. They're not already in team
4. Team isn't full (Pro teams cap at 10 members)

### Member can't see alerts

**Check:**

1. Alert is team alert (not personal)
2. Member accepted invitation
3. Member's app is up to date
4. They're in the right team

### Notification not showing for member

**Check:**

1. Alert is active (toggle on)
2. Notifications enabled in settings
3. Member has allowed notifications
4. Webhook was triggered

### Want to make alert personal

1. Go to alert
2. Tap "Edit"
3. Change from "Team" to "Personal"
4. Save

Only you will see it now.

### Team too large?

Create multiple teams:

* Team A: Engineering
* Team B: Product
* Team C: Finance

Organize by function or department.

## Migration from Personal to Team

Want to convert personal alert to team?

1. Note the alert details (template, config)
2. Delete personal alert
3. Create new team alert with same details
4. Test webhook

Or contact support for help migrating.

## Support

Need help with teams?

* Check [FAQ](/resources/faq)
* Browse [Troubleshooting](/guides/troubleshooting)
* Report issues on [GitHub](https://github.com/bhupeshpradhan/dashtray)

Teams make collaboration easy. Get started today! 👥


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.