Multi-use invites & seat pools
Pass maxUses to turn an invite into a seat pool — a link usable up to N times. null makes it unlimited; the default is 1 (single use):
$invite = Teams::for($team)->invites()->create(role: 'member', maxUses: 5);
// ... three people accept ...
$invite->consumedSeats(); // 3
$invite->remainingSeats(); // 2 (null when unlimited)
$invite->hasRemainingSeats(); // true
$invite->isExhausted(); // false
// Unlimited seats:
$link = Teams::for($team)->invites()->create(role: 'member', maxUses: null);| Method | Returns | Meaning |
|---|---|---|
consumedSeats() | int | How many times the invite was accepted (uses). |
remainingSeats() | ?int | max_uses − uses, never below 0; null when unlimited. |
hasRemainingSeats() | bool | True when unlimited or at least one seat is left. |
isExhausted() | bool | uses ≥ max_uses; always false when unlimited. |
acceptedMembers() / consumers() | HasMany<Member> | The members who joined through this invite. |
The seat ledger
Every accept stamps the membership’s accepted_invite_id, so the invite knows exactly who consumed each seat. The roster is a regular relation — eager-load or paginate it:
$invite->acceptedMembers; // Collection<Member> — who used a seat
$invite->consumers(); // readable alias of acceptedMembers()
$invite->acceptedMembers()->with('member')->paginate(20);
// From the member side:
$member->acceptedInvite; // the Invite this member joined through, or nullForce-deleting or hard-pruning an invite nulls accepted_invite_id on its members instead of deleting them, so the membership roster is never lost to invite cleanup. Re-adding an active member never rewrites the invite they originally joined through.
Show your open-source love
This package is free and MIT-licensed. If it saves you time, a one-off donation or a Patreon membership keeps it maintained, tested and documented.
More ways to support, including cryptoBy donating, you agree to our donation terms.
Want this built into your product?
We integrate our packages into custom Laravel and AI builds. Tell us what you're working on and we'll reply within 48 hours.