Invite and manage members
Bring people in with a link, change what they can do, reset a password and hand over ownership when you need to.
- Time
- About 12 min
- Who can do it
- Admins (members.invite, members.update, members.remove)
- Where
- Members, in the console
- You finish with
- People in the organization with the right role
What and why#
People join a FlagSwift organization by invitation. An invitation is a single-use link for one email address and one role: nobody can sign up into your organization on their own, and the link carries the role the person will hold when they arrive. Once they are in, you keep control of their access from the same page.
Two ways in#
Every invitation comes with a link and a one-time password. The person can open the link and choose their own password, or sign in with their email and the one-time password. Both routes accept the invitation. The link is the better route because it lets them choose a password straight away; the one-time password is a fallback for when a link cannot be delivered.
What you can manage afterwards#
Change a role, remove someone, reset a password and transfer ownership. A few rules keep the organization from locking itself out; they are listed under the steps.
Before you start#
- Inviting takes the
members.invitepermission, changing roles and resetting passwords takemembers.update, and removing takesmembers.remove. Admins hold all three. - Decide the role first. Only the owner can invite someone as an admin. If you need a role that does not exist yet, see Create a custom role.
- Your server must have an email provider (
RESEND_API_KEYwithMAIL_FROM, orSMTP_HOSTwith the relatedSMTP_*settings). If a send fails, for example because the sender is not verified, the invitation is still created and the dialog shows the reason so you can pass the link on yourself. - The person must not already belong to an organization. One email address can belong to one organization.
Walk through it#
Invite one person
Open Members and choose Invite member.
Invite member Field Rule Description Full name Required, up to 80 characters Shown on the Members tab. The person can change it when they accept. Work email Required, a valid address Stored in lower case. Used as their username. Role Required Built-in or custom. The picker only offers roles you may hand out. Send it. The confirmation, titled Invitation ready, shows the invitation link, the email as a username and a one-time password. The link works once and expires after 7 days. It is shown only now, because only a hash is stored. If your server has SMTP configured the link is emailed too, and the dialog says whether that worked. Otherwise use Copy everything as a message and send the details privately.
The Invite member dialog. The Role list shows only roles you may hand out, each with a one-line description. You should see. The invitation appears under Pending invitations with the role and an expiry date. If you invite an address that already has an open invitation, the new one replaces it and only the newest link works.Invite a team at once
Choose Bulk invite. Paste addresses one per line, as
email, asName <email>or asemail, Name, up to 50 at a time. People pasted without a name are named from their email, sojane.doe@example.combecomes Jane Doe. Repeated addresses are dropped and lines without an email are flagged before you send. Pick one role for everyone. Each address succeeds or fails on its own, and the results list shows which, with a copy button for each person.What the person does
They open the link, which shows the organization name, the role and who invited them. A new person chooses a password. Someone whose account has no organization yet confirms with the password they already have. A new password needs at least 6 characters, including a number, a symbol, and upper and lower case letters, and at most 72 bytes; the form shows a checklist as they type. Accepting signs them in and ends any other session they had.
Manage pending invitations
The Pending invitations tab lists invitations that are pending or expired, newest first. Accepted and revoked ones leave the list. Use Create new link if one was lost or expired: you confirm first, and it replaces the old link and password and starts a fresh 7 days. Use Revoke invitation to stop its link and password working.
Pending invitations. An expired one offers Renew link instead of New link. Create new link asks first, because the old link stops working. The button is the brand colour: nothing is lost that you cannot recreate. The dialog is locked while the link is made. Revoke invitation. The person can be invited again at any time. Change a role or remove someone
On the Members tab, change a person's role from the role menu on their row, or use the remove button. A row only offers roles you are allowed to hand out. Picking a role opens a confirmation, and nothing changes until you confirm; demoting an admin warns that their admin access ends straight away. Removing also asks you to confirm. Removed people lose access at once and are detached from the organization. Their past changes stay in the audit log. You cannot remove yourself.
The Members tab. The owner badge is green and each role has its own colour: admin blue, release manager amber, developer orange, viewer grey. Your own row, and rows you may not change, show a plain role badge instead of the role menu. Changing a role asks you to confirm. Demoting an admin turns the button red and says their administrator access ends straight away. Removing a member, and the same dialog while the request runs. It cannot be closed until it finishes. You should see. The row shows the new role. The audit log hasmember.role_changedormember.removed.Reset a password
The key button on a row opens Reset password. Confirm and it generates a new password and shows it once for you to pass on. The old password stops working and the person is signed out everywhere. You reset your own password from your account instead, with Change password.
Transfer ownership
The owner can choose Make owner on an admin's row. You stay an admin. Only the new owner can then appoint or remove admins, transfer ownership again, or deactivate the organization. Ownership can only go to an existing admin, so make the person an admin first.
Rules that protect the organization
Do it with the API
The Dashboard API takes a session cookie, not an API key. The link and password are in this response only, and the response is marked no-store. POST /api/invitations/bulk takes { role, invitees: [{ name, email }] }, up to 50. Reissue with POST /api/invitations/{id}/reissue, revoke with DELETE /api/invitations/{id}, remove a member with DELETE /api/members/{id}, reset a password with POST /api/members/{id}/reset-password and transfer ownership with POST /api/members/{id}/transfer-ownership. Details are in the Members and invitations API.
# Sign in first (POST /api/auth/login with -c jar.txt). Invitations need members.invite.
curl -s -b jar.txt -X POST https://flags.example.com/api/invitations \
-H "Content-Type: application/json" \
-d '{"name":"Ada Obi","email":"ada@example.com","role":"developer"}'{
"status": "success",
"message": "Invitation created",
"data": {
"invitation": {
"id": "inv_123",
"name": "Ada Obi",
"email": "ada@example.com",
"role": "developer",
"roleLabel": "Developer",
"customRoleId": null,
"status": "pending",
"invitedByEmail": "you@example.com",
"createdAt": "2026-10-03T09:30:00.000Z",
"expiresAt": "2026-10-10T09:30:00.000Z"
},
"inviteUrl": "https://flags.example.com/invite/TOKEN",
"temporaryPassword": "shown-once",
"emailed": false
}
}Good to know#
Send the link, not just the password
Not built yet
Can I see an invitation link again?
What if the email never arrives?
Can I invite someone who is already in another organization?
Does removing a member delete their work?
Who can reset an admin's password?
If something goes wrong#
This invitation link is invalid, expired or has already been used
Why: The link is older than 7 days, was revoked, was replaced by a newer link, or was already accepted. The message is the same for all of them on purpose.
Fix: Open Pending invitations and choose Create new link, then send the new details.
This person is already a member, or This email already belongs to another organization
Why: The address has an account with an organization already.
Fix: Use a different address, or ask the person to leave the other organization first.
Only the owner can make someone an administrator
Why: Admin is a role that only the owner can hand out or change.
Fix: Ask the owner, or have them transfer ownership to you.
This is the last administrator. Make someone else an administrator first
Why: You tried to demote or remove the only admin.
Fix: Promote another person to Admin first.
The Invite member button is missing
Why: Only people with members.invite see it. Without it the page ends with Only administrators can invite people or change roles.
Fix: Ask an Admin.
A row has a role badge but no role menu
Why: It is your own row, or the owner and admin rules lock it for you (for example an Admin row when you are not the owner). Hover the badge for the reason.
Fix: Ask the owner to make the change.
The invitation dialog says the email could not be sent
Why: An email provider is configured but the send failed, so the message gives the reason.
Fix: Copy the link and password and pass them on yourself, then ask your operator to check the email settings (Resend or SMTP).
What to check#
- The person opens the link and creates an account with a password they choose. They then show on the Members tab with the right role.
- Your invitation leaves Pending invitations once accepted.
- The audit log has
member.invitedandmember.joined.