Teams and round-robin
A team is a small pool of hosts who share event types. An invitee books a team event type and devalender assigns the booking to one of the members who is free at that time.
Set up a team
Creating a team needs the Teams plan. The owner pays a flat price and members need no plan: $15/mo or $135/yr for up to 5 hosts, never per seat. Teams includes everything in Pro.
- Create the team with a name and a slug in the dashboard, with
devalender teams create, or withPOST /teams. - Invite members by email. Invites expire after 7 days and the owner can revoke a pending one.
- Create team event types and choose which members take bookings. All members are selected by default and at least one is required.
Team event types are one-on-one. They live at /team/<team-slug>/<event-slug>.
How a booking is assigned
Only members who are available take part. Availability is each member's own schedule, existing bookings and connected Google Calendar busy time. Among those, devalender ranks members by:
- fewest confirmed bookings of this team's event types starting in the last 30 days,
- then the oldest last assignment (a member who was never assigned goes first),
- then host id, so the order is stable.
If the top member loses the slot to a concurrent booking, the next one is tried. If nobody is available the invitee gets the same response as for a single host. Per-day limits apply to each member separately.
The invitee's confirmation email reads "Intro call with Acme - Jane".
Reschedule and cancel
The invitee reschedules with their manage link. The current member keeps the booking when they are still free. Otherwise it is reassigned using the same fairness ranking. A reassigned reschedule notifies the previous member of the cancellation.
The invitee, the assigned member and the team owner can cancel. Another member of the team cannot, and receives 403 forbidden.
Webhooks follow the move: the old member's endpoints receive booking.cancelled and the new member's receive booking.created. When the same member keeps it, you get booking.rescheduled.
CLI
Everything above is scriptable. Run devalender teams --help or see the CLI reference.
devalender teams create --name "Acme" --slug acme
devalender teams invite <team-id> --email [email protected]
devalender teams create-event-type <team-id> --title "Intro" --duration 30
devalender teams slots acme/intro --from 2030-01-07 --to 2030-01-14 --json
devalender teams book acme/intro --start 2030-01-07T10:00:00Z --name Bob --email [email protected]
devalender teams bookings <team-id> --status confirmed --jsonteams bookings is owner-only. Members see their own team bookings in devalender bookings list.
Embed
Use team instead of handle on the booking widget and the slot picker:
<script src="https://devalender.com/widget.js"></script>
<devalender-booking team="acme" event="intro"></devalender-booking>When both are set, team wins. The embed builder has a team option that checks the team and event exist before it gives you a snippet.