# Invitations: questions and answers

Short answers about inviting people: sending, the email, expiry, resending,
revoking, accepting and what the messages mean. Each answer links to the
section of [Invitations](../organizations/invitations.md) that owns the
rule.

## Sending an invitation

### What is an invitation?

An invitation asks one email address to join an organization. It names the
organization role the person gets and, optionally, the workspaces they
join. Talewright emails the address a link that works once and for 7 days.

More: [Invitations, Summary](../organizations/invitations.md#summary)

### How do I invite someone to my organization?

As an owner or admin, open **Settings > Organization > Members**, choose
"Invite member", fill in "Email", choose a "Role" and, for a member, the
"Workspaces". Then choose "Send invitation".

More: [Invitations, Inviting](../organizations/invitations.md#inviting)

### Who can invite people to an organization?

Owners and admins. Owners invite with any role. Admins invite admins and
members.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### Can a member invite someone?

No. A member who tries gets `403 FORBIDDEN`. Members do not see the
"Invitations" section at all.

More: [Invitations, Who can do what](../organizations/invitations.md#who-can-do-what)

### Can an admin invite an owner?

No. Only owners invite owners. An admin who tries gets `403 FORBIDDEN`: no
invitation, no email.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### Can I invite someone who has no Talewright account?

Yes. An address can be invited whether or not it has an account. The person
creates one from the invitation link, with the invited address.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### Can I invite several people at once?

No. There is one address per invitation. Send one invitation for each
person.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### Do I need a verified email address to invite people?

No. Neither inviting nor accepting needs a verified email.

More: [Invitations, Who can do what](../organizations/invitations.md#who-can-do-what)

### What does an invitation consist of?

Three parts: an email address, an organization role, and zero or more
workspaces of the organization.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### Which roles can I invite someone with?

`owner`, `admin` or `member`. Only an owner can choose owner.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### Can I invite someone without choosing a workspace?

Yes. The person then joins the organization only. A plain member invited
that way can open no workspace until an owner or admin adds them to one. They
still read the member list and the organization folder.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### How many workspaces can one invitation name?

At most 100. Naming one twice counts once.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### Which role does the invitee get in the workspaces of the invitation?

The same role as their organization role. Someone invited as member gets a
workspace membership as member in each named workspace.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### Can I invite someone to one workspace only, not to the organization?

No. Everyone in a workspace is a member of the organization. Invite them as
"Member" and tick only that workspace: they then see only that workspace.

More: [Workspaces, Workspace membership](../organizations/workspaces.md#workspace-membership)

### Can I invite someone as admin of just one workspace?

Not in one step. An invitation gives the same role in its workspaces as in
the organization. Invite them as "Member", and after they join give them
the workspace role admin in that workspace.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### Can I invite someone who is already a member?

No. An address that already belongs to a member answers `409 CONFLICT`. The
app says "This address belongs to a member." Change their role or
workspaces instead.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### What happens if I invite my own address?

It is refused with `409 CONFLICT`, because you are already a member.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### Can the same address be invited to several organizations?

Yes. There is one invitation per address per organization, and the same
address can hold invitations to several organizations at once.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### Does an invitation create an account or reserve the address?

No. Nothing exists for the person until they create an account themselves.

More: [Invitations, Questions and answers](../organizations/invitations.md#questions-and-answers)

### Can I invite people with a shareable link instead of an email?

No. An invitation is always sent to one email address, and only an account
with exactly that address can accept it.

More: [Invitations, Accepting](../organizations/invitations.md#accepting)

### Is `Ada@Example.com` a different invitation from `ada@example.com`?

No. The address is stored trimmed and in lower case. Both, and
` ada@example.com ` with spaces around it, are the same invitation.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### What counts as a valid email address for an invitation?

Something before one `@`, something after it, no spaces or control
characters, and at most 320 characters.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### Why is the workspace choice missing when I invite an admin or owner?

The workspace choice is shown only for "Member". Admins and owners reach
every workspace anyway, so the app sends no workspaces for them.

More: [Invitations, Inviting](../organizations/invitations.md#inviting)

### What happens if an admin or owner is invited with workspaces through the API?

They get workspace memberships with that role in those workspaces, and
reach every other workspace through their role as well.

More: [Invitations, Edge cases](../organizations/invitations.md#edge-cases)

### Why is "Owner" missing from the Role choices when I invite?

"Owner" is offered to owners only. An admin can choose "Member" or "Admin".

More: [Invitations, Inviting](../organizations/invitations.md#inviting)

### What does the "Invite member" dialog tell me?

"We email them a link to join {organization}. It works once and expires
after 7 days."

More: [Invitations, Inviting](../organizations/invitations.md#inviting)

### Is the workspace selected for me when the organization has only one?

Yes. When the organization has exactly one workspace, it is ticked already.

More: [Invitations, Inviting](../organizations/invitations.md#inviting)

### What happens if I double-click "Send invitation"?

One invitation is sent, with one email.

More: [Invitations, Inviting](../organizations/invitations.md#inviting)

### What is the difference between "Invitation sent to {address}" and "Invitation resent to {address}"?

"Invitation sent" means a new invitation was made. "Invitation resent"
means the address already had a pending invitation, which got a new link.

More: [Invitations, Inviting](../organizations/invitations.md#inviting)

### Can I add a personal message to an invitation?

No. An invitation holds an address, a role and workspaces. The email's text
is fixed.

More: [Invitations, The email](../organizations/invitations.md#the-email)

### Can I choose how long an invitation stays valid?

No. Every invitation lasts 7 days from the moment it is sent or resent.

More: [Invitations, Expiry](../organizations/invitations.md#expiry)

### Can I invite people to a deleted organization?

No. New invitations cannot be sent to a deleted organization.

More: [Invitations, While the organization is deleted](../organizations/invitations.md#while-the-organization-is-deleted)

### Can I name a workspace of another organization in an invitation?

No. The workspaces must be live workspaces of this organization. Anything
else answers `422 VALIDATION_FAILED` on `workspaceIDs`.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### What does the hint "They join the chosen workspaces with the same role. You can assign workspaces later." mean?

The workspaces you tick give the invitee a workspace membership with their
organization role. You may tick none and add them to workspaces after they
join.

More: [Invitations, Inviting](../organizations/invitations.md#inviting)

## The invitation email

### What does the invitation email say?

Its subject is "{organization} invited you to join Talewright". It names
the inviter, the organization and the role, lists the workspaces when the
invitation names any, and has the button "Accept invitation".

More: [Invitations, The email](../organizations/invitations.md#the-email)

### Are reminder emails sent for an invitation?

No. Every invitation and every resend sends one email to the invited
address. There are no reminders.

More: [Invitations, The email](../organizations/invitations.md#the-email)

### Does the invitation email list the workspaces I will join?

Yes, when the invitation names workspaces. They are listed by name, in
alphabetical order.

More: [Invitations, The email](../organizations/invitations.md#the-email)

### The organization was renamed after the email was sent. Does the link still work?

Yes. The email still shows the old name, the invitation page shows the new
one, and the link works.

More: [Invitations, The email](../organizations/invitations.md#the-email)

### The invitation email did not arrive or went to spam. What can I do?

Ask the inviter to invite the same address again. That sends a new email
with a new link, and the earlier link stops working. No reminder is sent by
itself.

More: [Invitations, Resending](../organizations/invitations.md#resending)

### I invited the wrong address. What do I do?

Revoke the invitation, then invite the right address. Until it is revoked,
whoever holds an account with the invited address can join.

More: [Invitations, Revoking](../organizations/invitations.md#revoking)

### I received an invitation I was not expecting. What should I do?

Nothing. The email says "If you were not expecting it, you can safely
ignore this message." You join only if you accept.

More: [Invitations, The email](../organizations/invitations.md#the-email)

### What does the "Accept invitation" button in the email do?

It opens the invitation page of the app with the link's secret. You still
have to sign in or create an account, and then choose "Accept invitation"
on that page.

More: [Invitations, The email](../organizations/invitations.md#the-email)

### Why does the email tell me to sign in before accepting?

Only a signed-in account whose email is the invited address can accept. The
email says "If you already have a Talewright account, sign in before
accepting so we can add you immediately."

More: [Invitations, The email](../organizations/invitations.md#the-email)

### Which workspaces does the email of a resent invitation name?

Every workspace the invitation now grants: the earlier ones plus the new
ones.

More: [Invitations, The email](../organizations/invitations.md#the-email)

## Expiry

### How long is an invitation valid?

7 days from the moment it was sent or resent.

More: [Invitations, Expiry](../organizations/invitations.md#expiry)

### What happens when an invitation expires?

Its link answers `400 TOKEN_INVALID`, and it is no longer in the pending
list. Expired invitations are cleared away automatically.

More: [Invitations, Expiry](../organizations/invitations.md#expiry)

### Can I extend an expired invitation?

No. An expired invitation is not extended. Invite the address again: that
makes a fresh invitation with a new link and a new 7 days.

More: [Invitations, Expiry](../organizations/invitations.md#expiry)

### How often does an invitation link work?

Once. Accepting uses the invitation up, and the link never works again.

More: [Invitations, Accepting](../organizations/invitations.md#accepting)

### Does an invitation that was never accepted leave anything behind?

No. After 7 days it expires and is cleared away. The person is not a member
and has no account unless they created one themselves.

More: [Invitations, Expiry](../organizations/invitations.md#expiry)

## Resending and changing

### How do I resend an invitation?

Invite the same address again. There is no separate resend action. The
person gets a new email with a new link.

More: [Invitations, Resending](../organizations/invitations.md#resending)

### Does the old link still work after an invitation is resent?

No. The earlier link stops working at once. Only the newest link works.

More: [Invitations, Resending](../organizations/invitations.md#resending)

### Does resending an invitation restart its 7 days?

Yes. The 7 days start again.

More: [Invitations, Resending](../organizations/invitations.md#resending)

### Can I change the role of a pending invitation?

Yes, by inviting the address again with the other role. The new role
replaces the old one. Only an owner changes a pending owner invitation this
way.

More: [Invitations, Resending](../organizations/invitations.md#resending)

### Can I add workspaces to a pending invitation?

Yes. Invite the address again with the additional workspaces. The
invitation then grants the earlier workspaces plus the new ones.

More: [Invitations, Resending](../organizations/invitations.md#resending)

### Can I take a workspace away from a pending invitation?

Not by resending: a resend never takes a workspace away. Revoke the
invitation and invite again.

More: [Invitations, Resending](../organizations/invitations.md#resending)

### Who counts as the inviter after an invitation is resent?

The person who resent it. The invitation then belongs to them.

More: [Invitations, Resending](../organizations/invitations.md#resending)

### Can an admin resend an invitation that invites an owner?

No. An admin cannot resend a pending invitation whose role is owner, with
any new role: `403 FORBIDDEN`. The invitation, its inviter and its link
stay as they were. Owners resend any invitation.

More: [Invitations, Resending](../organizations/invitations.md#resending)

### Is inviting an address whose invitation expired a resend?

No. The old invitation is replaced outright. Only the new role and the new
workspaces apply, and `resent` is `false`.

More: [Invitations, Resending](../organizations/invitations.md#resending)

### Does a resend count against the hourly invitation limits?

Yes. A resend counts like a new invitation.

More: [Invitations, Resending](../organizations/invitations.md#resending)

### I got two invitation emails from the same organization. Which link do I use?

The newest. Earlier links to the same organization no longer work.

More: [Invitations, Resending](../organizations/invitations.md#resending)

### Does an invitation keep its ID when it is resent?

Yes. It stays one invitation with the same ID. The API answer has
`resent: true`.

More: [Invitations, Resending](../organizations/invitations.md#resending)

### Why does the app say "Your role no longer allows that" when I invite an address as an admin?

Your role was lowered since the page loaded, or the address has a pending
owner invitation, which an admin cannot change. The dialog closes.

More: [Invitations, Inviting](../organizations/invitations.md#inviting)

## The pending list

### Where do I see who has not accepted yet?

Under "Invitations" on **Settings > Organization > Members**. Pending
invitations are listed there with their expiry.

More: [Invitations, The pending list in the app](../organizations/invitations.md#the-pending-list-in-the-app)

### Who can see the pending invitations?

Owners and admins. A member who asks for the list through the API gets
`403 FORBIDDEN`.

More: [Invitations, The pending list](../organizations/invitations.md#the-pending-list)

### What does a row of the pending list show?

The address under "Email", the role and workspaces under "Role", such as
"Member in Brand, Campaigns", who sent it under "Invited by", and when it
expires under "Expires".

More: [Invitations, The pending list in the app](../organizations/invitations.md#the-pending-list-in-the-app)

### In what order are pending invitations listed?

Newest first. A resent invitation moves to the top.

More: [Invitations, The pending list](../organizations/invitations.md#the-pending-list)

### What does "No pending invitations." mean?

No invitation of the organization is waiting to be accepted. Accepted,
revoked and expired invitations are not listed.

More: [Invitations, The pending list in the app](../organizations/invitations.md#the-pending-list-in-the-app)

### Why did a workspace disappear from a pending invitation?

The workspace was deleted. A deleted workspace is left out of an entry's
workspaces. It is back in the entry if the workspace is restored.

More: [Invitations, The pending list](../organizations/invitations.md#the-pending-list)

### Am I told when someone accepts my invitation?

No email is sent. They appear in the member list and leave the pending
list.

More: [Invitations, Accepting](../organizations/invitations.md#accepting)

### Can I see invitations that were accepted, revoked or expired?

No. Expired, accepted and revoked invitations are not listed.

More: [Invitations, The pending list](../organizations/invitations.md#the-pending-list)

### Can I see who sent a pending invitation?

Yes. Each entry names who invited, next to the address, the role, the
workspaces, when it was sent and when it expires.

More: [Invitations, The pending list](../organizations/invitations.md#the-pending-list)

### How many pending invitations can one address have in an organization?

One. Inviting the address again resends that invitation.

More: [Invitations, Limits](../organizations/invitations.md#limits)

## Revoking

### How do I revoke an invitation?

Choose "Revoke" on the invitation's row, then confirm "Revoke invitation?"
with "Revoke invitation". The app shows "Invitation revoked" and the row
disappears.

More: [Invitations, Revoking in the app](../organizations/invitations.md#revoking-in-the-app)

### Who can revoke an invitation?

Owners and admins revoke any invitation of the organization, including one
sent by someone else.

More: [Invitations, Revoking](../organizations/invitations.md#revoking)

### Can an admin revoke an invitation that invites an owner?

Yes. Admins cannot send or resend an owner invitation, but they can revoke
one.

More: [Invitations, Revoking](../organizations/invitations.md#revoking)

### Is the invitee told when I revoke their invitation?

No. No email is sent. Their link simply stops working.

More: [Invitations, Revoking](../organizations/invitations.md#revoking)

### Can I undo revoking an invitation?

No. A revoked invitation cannot be brought back. Invite again to send a new
one.

More: [Invitations, Revoking](../organizations/invitations.md#revoking)

### What does the invitee see after their invitation was revoked?

"Link expired or invalid". The link answers `400 TOKEN_INVALID`, the same
as for an expired or used link.

More: [Invitations, Revoking](../organizations/invitations.md#revoking)

### What happens if an invitation is revoked at the moment it is being accepted?

Exactly one of the two happens. Either the person joins and the revoke gets
`404 NOT_FOUND`, or the invitation is revoked and the accept gets
`400 TOKEN_INVALID`.

More: [Invitations, Edge cases](../organizations/invitations.md#edge-cases)

### What does "Could not revoke the invitation. Try again." mean?

Revoking failed. The invitation is still pending. Try again, or reload the
list to see whether it was accepted meanwhile.

More: [Invitations, Revoking in the app](../organizations/invitations.md#revoking-in-the-app)

### Why do I get `404 NOT_FOUND` when I revoke an invitation?

It does not exist in the organization any more: it was accepted or revoked
a moment earlier. Reload the pending list.

More: [Invitations, Revoking](../organizations/invitations.md#revoking)

### Does revoking an invitation remove someone who already accepted it?

No. An accepted invitation is used up and no longer exists to revoke. To
end that person's access, remove them from the organization.

More: [Members and roles, Removing members](../organizations/members-and-roles.md#removing-members)

## When the inviter changes

### What happens to my pending invitations if I leave the organization?

They are deleted and their links stop working. Someone else has to invite
those people again.

More: [Invitations, Invitations end with their inviter's rights](../organizations/invitations.md#invitations-end-with-their-inviters-rights)

### What happens to pending invitations when their inviter is removed?

All the pending invitations they sent for the organization are deleted.
Their links answer `400 TOKEN_INVALID`.

More: [Invitations, Invitations end with their inviter's rights](../organizations/invitations.md#invitations-end-with-their-inviters-rights)

### What happens to pending invitations when their inviter deletes their account?

All their pending invitations, in every organization, are deleted.

More: [Invitations, Invitations end with their inviter's rights](../organizations/invitations.md#invitations-end-with-their-inviters-rights)

### What happens to an admin's invitations when the admin is made a member?

All their pending invitations for the organization are deleted. Members
cannot invite.

More: [Invitations, Invitations end with their inviter's rights](../organizations/invitations.md#invitations-end-with-their-inviters-rights)

### What happens to an owner's invitations when the owner is made an admin?

The owner invitations they sent are deleted. Their admin and member
invitations stay, because an admin could still have sent those.

More: [Invitations, Invitations end with their inviter's rights](../organizations/invitations.md#invitations-end-with-their-inviters-rights)

### Why did a pending invitation disappear although nobody revoked it?

It expired after 7 days, or the person who sent it left, was removed,
deleted their account or had their role lowered. An invitation lasts only
as long as its sender could still send it.

More: [Invitations, Invitations end with their inviter's rights](../organizations/invitations.md#invitations-end-with-their-inviters-rights)

### Are other people's invitations affected when one inviter leaves?

No. Invitations sent by other people are never affected.

More: [Invitations, Invitations end with their inviter's rights](../organizations/invitations.md#invitations-end-with-their-inviters-rights)

### How do I keep an invitation alive when its inviter is about to leave?

Have another owner or admin invite the same address again while it is
pending. A resent invitation belongs to the person who resent it. The
invitee gets a new link, and the role becomes the one of the new request.
An admin cannot do this for an owner invitation; that needs an owner.

More: [Invitations, Invitations end with their inviter's rights](../organizations/invitations.md#invitations-end-with-their-inviters-rights)

## Accepting an invitation

### How do I accept an invitation?

Open the link in the email. Sign in, or create an account, with the invited
address. Then choose "Accept invitation" on the invitation page.

More: [Invitations, Opening an invitation link](../organizations/invitations.md#opening-an-invitation-link)

### Can I accept with a different email address than the one invited?

No. If your account is under another address, ask to be invited at that
address, or change your account's email to the invited address first and
then accept: the check uses the account's current address.

More: [Invitations, Accepting](../organizations/invitations.md#accepting)

### Does upper and lower case matter in the address when I accept?

No. Upper and lower case do not matter. Everything else must match.

More: [Invitations, Accepting](../organizations/invitations.md#accepting)

### Can I accept as `name+work@example.com` when `name@example.com` was invited?

No. Apart from case, the address must be identical. The accept answers
`403 FORBIDDEN`.

More: [Invitations, Accepting](../organizations/invitations.md#accepting)

### Do I have to verify my email after accepting an invitation?

No. Accepting the invitation verifies it. Only the holder of that inbox
received the link.

More: [Invitations, Accepting](../organizations/invitations.md#accepting)

### What happens when I accept an invitation?

Your account joins the organization with the invited role. It gets a
workspace membership, with the same role, in every named workspace that is
live at that moment. Your email address becomes verified. The invitation is
used up and deleted.

More: [Invitations, Accepting](../organizations/invitations.md#accepting)

### Where do I land after accepting an invitation?

In Files & Assets of the first workspace you can now open, and the app
shows "You joined {organization}".

More: [Invitations, Signed in with the invited address](../organizations/invitations.md#signed-in-with-the-invited-address)

### What does "An owner or admin adds you to its workspaces." mean after I joined?

The invitation gave you no workspace. You belong to the organization, but
can open no workspace until an owner or admin adds you to one.

More: [Invitations, Signed in with the invited address](../organizations/invitations.md#signed-in-with-the-invited-address)

### Can an invitation be accepted twice?

No. An invitation is accepted once. A second attempt, also a double click
or two browsers at once, gets `400 TOKEN_INVALID`.

More: [Invitations, Accepting](../organizations/invitations.md#accepting)

### The link says "Link expired or invalid". Why?

It was already used, it is older than 7 days, a newer invitation replaced
it, it was revoked, the person who sent it left or lost the right to
invite, or the organization was deleted. Ask for a new invitation.

More: [Invitations, Opening an invitation link](../organizations/invitations.md#opening-an-invitation-link)

### What does "This invitation is for {invited address}" mean?

You are signed in with another address than the invited one. The page adds
"Sign in with that address to accept it." and does not offer "Accept
invitation".

More: [Invitations, Signed in with another address](../organizations/invitations.md#signed-in-with-another-address)

### What does "Sign in with another account" do on the invitation page?

It signs you out and opens the sign-in page. The invitation is kept, so
signing in with the right account brings you back to it.

More: [Invitations, Signed in with another address](../organizations/invitations.md#signed-in-with-another-address)

### What does "Continue without joining" do?

It forgets the invitation in this browser and takes you home. The link
itself keeps working.

More: [Invitations, Signed in with another address](../organizations/invitations.md#signed-in-with-another-address)

### What does "You are already a member" mean on the invitation page?

Your account already belongs to the organization. The page says "You
already belong to {organization}." The invitation is left as it is and
nothing about your account changes.

More: [Invitations, Already a member](../organizations/invitations.md#already-a-member)

### Can I decline an invitation?

There is no decline. Ignore the email, or choose "Continue without joining"
on the invitation page. The invitation expires by itself after 7 days.

More: [Invitations, Signed in with another address](../organizations/invitations.md#signed-in-with-another-address)

### Can someone else use my invitation link?

They can see what it offers: the invited address, the organization, the
inviter and the role. They cannot accept it without an account for the
invited address.

More: [Invitations, What a link shows before it is accepted](../organizations/invitations.md#what-a-link-shows-before-it-is-accepted)

### Is an invitation link safe to forward?

Forwarding gives away the four preview details, nothing more. Still, treat
it as personal: whoever controls the invited inbox can join.

More: [Invitations, What a link shows before it is accepted](../organizations/invitations.md#what-a-link-shows-before-it-is-accepted)

### What does an invitation link show before it is accepted?

Exactly four things: the invited address, the organization's name, the
inviter's name and the role. No workspaces, no members, no files.

More: [Invitations, What a link shows before it is accepted](../organizations/invitations.md#what-a-link-shows-before-it-is-accepted)

### Can I see which workspaces I will join before I accept?

Not on the invitation page: the preview shows no workspaces. The invitation
email lists them when the invitation names any.

More: [Invitations, What a link shows before it is accepted](../organizations/invitations.md#what-a-link-shows-before-it-is-accepted)

### I created an account from the invitation link but never accepted. Am I a member?

No. The account exists, signed in and unverified, and is not a member of
anything. The invitation stays pending until it expires. Creating an
account and accepting are separate steps.

More: [Invitations, Edge cases](../organizations/invitations.md#edge-cases)

### I already have an account and chose "Create account" on the invitation. What happens?

No second account is made. The existing account gets an email saying it
already exists. Sign in instead.

More: [Invitations, Edge cases](../organizations/invitations.md#edge-cases)

### Can I accept an invitation while signed out?

No. Signed out, you see the preview and the page says "Sign in or create an
account with {address}." Accepting needs to know who you are.

More: [Invitations, Signed out](../organizations/invitations.md#signed-out)

### Why does the app open an invitation every time I go to home?

The browser keeps an invitation from the moment you open its link. While it
is kept, opening the app's home takes you to the invitation first, also if
your account already has workspaces.

More: [Invitations, A kept invitation comes first](../organizations/invitations.md#a-kept-invitation-comes-first)

### How do I make the app stop showing me a kept invitation?

Accept it, or choose "Continue without joining". It is also forgotten when
it turns out to be invalid, when you turn out to be a member already, and
when you sign out.

More: [Invitations, A kept invitation comes first](../organizations/invitations.md#a-kept-invitation-comes-first)

### I opened an invitation on a shared computer and signed out. Can the next person use it?

No. Signing out forgets the kept invitation in that browser, so the next
person is not handed it. The emailed link still works for you.

More: [Invitations, A kept invitation comes first](../organizations/invitations.md#a-kept-invitation-comes-first)

### Does the invitation link's secret stay in my browser history?

No. The invitation page takes the secret out of the address bar and the
browser history at once.

More: [Invitations, Opening an invitation link](../organizations/invitations.md#opening-an-invitation-link)

### What does "Opening your invitation" mean?

The page is checking the link. It adds "One moment while we check the
link." A good link then shows "Join {organization}".

More: [Invitations, Opening an invitation link](../organizations/invitations.md#opening-an-invitation-link)

### What does "Could not open the invitation" mean?

The link could not be checked at all. The page says "Something went wrong.
Try again." and offers "Try again". This is not the same as an expired
link.

More: [Invitations, Opening an invitation link](../organizations/invitations.md#opening-an-invitation-link)

### A workspace named in my invitation was deleted before I accepted. What do I get?

You join the organization and the other named workspaces. You are not added
to the deleted one, also not if it is restored later.

More: [Invitations, Accepting](../organizations/invitations.md#accepting)

### The invitation expired while I had the invitation page open. What happens?

Accepting answers `400 TOKEN_INVALID` and the page shows "Link expired or
invalid". Expiry is checked at the moment of accepting.

More: [Invitations, Edge cases](../organizations/invitations.md#edge-cases)

### What happens to my sign-up verification link after I accept an invitation?

It stops working. Accepting verified the address, so a verification link
the account was sent earlier answers `400 TOKEN_INVALID`.

More: [Invitations, Accepting](../organizations/invitations.md#accepting)

### Do I get a verification email when I sign up from an invitation?

No. An account created from a live invitation to its own address gets no
verification email. Accepting the invitation verifies the address.

More: [Invitations, Closed sign-up and invitations](../organizations/invitations.md#closed-sign-up-and-invitations)

### Can I change the email address on the sign-up form opened from an invitation?

No. "Email" already holds the invited address and cannot be changed. You
enter your name and a password.

More: [Invitations, Signed out](../organizations/invitations.md#signed-out)

### Can an account with an unverified email accept an invitation?

Yes. The account may be verified or unverified. Accepting makes it
verified.

More: [Invitations, Accepting](../organizations/invitations.md#accepting)

### In which order are the checks made when an invitation is accepted?

Sign-in (`401`), then the link (`400 TOKEN_INVALID`), then the account's
address (`403 FORBIDDEN`), then whether the account is already a member
(`409 CONFLICT`). Otherwise the account joins: `200`.

More: [Invitations, Accepting](../organizations/invitations.md#accepting)

### Does the link stop working if I try to accept with the wrong account?

No. The accept answers `403 FORBIDDEN`, the account is not added, and the
link stays usable for the right account.

More: [Invitations, Accepting](../organizations/invitations.md#accepting)

### What does the invitation page show for a good link?

"Join {organization}" and "{inviter} invited you to join {organization} as
a member." (or "as an admin", "as an owner").

More: [Invitations, Opening an invitation link](../organizations/invitations.md#opening-an-invitation-link)

### How does the invitation survive while I sign in or create an account?

The browser keeps the invitation while you do either, so you come back to
it afterwards. The link's secret is not passed along in any address.

More: [Invitations, Signed out](../organizations/invitations.md#signed-out)

### I accepted an invitation and was already a member of other organizations. Does anything change there?

No. Accepting adds one membership. Your other organizations, roles and
credentials are untouched.

More: [Organizations, Belonging to several organizations](../organizations/organizations.md#belonging-to-several-organizations)

## Closed sign-up

### Sign-up is closed. How does a new colleague get an account?

Invite them. Starting from the invitation link, they can create an account
for the invited address.

More: [Invitations, Closed sign-up and invitations](../organizations/invitations.md#closed-sign-up-and-invitations)

### What does `SIGNUP_CLOSED` mean?

Someone tried to create an account while sign-up is closed, without a live
invitation to that address. Start from the invitation link.

More: [Invitations, Errors](../organizations/invitations.md#errors)

### What does "Sign-up is by invitation" mean on the sign-up page?

Sign-up is closed and you tried to create an account without an invitation.
The page says "To create an account, open the link in your invitation
email."

More: [Invitations, Sign-up closed](../organizations/invitations.md#sign-up-closed)

### Does creating an account from an invitation use the invitation up?

No. Signing up does not use up the invitation. It is accepted afterwards,
as a separate step.

More: [Invitations, Closed sign-up and invitations](../organizations/invitations.md#closed-sign-up-and-invitations)

### Can someone sign up with another person's invitation link while sign-up is closed?

No. The secret admits only the address it was sent to. Anyone else gets
`403 SIGNUP_CLOSED` and no account is made.

More: [Invitations, Closed sign-up and invitations](../organizations/invitations.md#closed-sign-up-and-invitations)

### Does closed sign-up stop people who already have an account from accepting?

No. An account that already exists is not affected. It signs in and accepts
invitations as usual.

More: [Invitations, Closed sign-up and invitations](../organizations/invitations.md#closed-sign-up-and-invitations)

### Sign-up is closed and my invitation was revoked. Can I still create an account?

No. A revoked invitation admits nobody. The sign-up answers
`403 SIGNUP_CLOSED`. The same goes for a used or expired invitation.

More: [Invitations, Closed sign-up and invitations](../organizations/invitations.md#closed-sign-up-and-invitations)

### Sign-up is open and a stranger signs up carrying someone else's invitation secret. What happens?

Their account is created and gets the normal verification email. The
invitation is untouched. The secret spares a verification email only for
the invited address.

More: [Invitations, Edge cases](../organizations/invitations.md#edge-cases)

## While the organization is deleted

### What happens to pending invitations when the organization is deleted?

They cannot be previewed or accepted. Their links answer
`400 TOKEN_INVALID`.

More: [Invitations, While the organization is deleted](../organizations/invitations.md#while-the-organization-is-deleted)

### Do invitation links work again when the organization is restored?

Yes, if the invitation has not expired meanwhile.

More: [Invitations, While the organization is deleted](../organizations/invitations.md#while-the-organization-is-deleted)

### Do an invitation's 7 days pause while the organization is deleted?

No. Their 7 days keep running.

More: [Invitations, While the organization is deleted](../organizations/invitations.md#while-the-organization-is-deleted)

## Limits and messages

### How many invitations can I send in an hour?

50. The count covers all your organizations together.

More: [Invitations, Limits](../organizations/invitations.md#limits)

### How many invitations can one organization send in an hour?

200, across all its inviters.

More: [Invitations, Limits](../organizations/invitations.md#limits)

### Why does it say "Too many invitations"?

One person can send 50 invitations an hour, and one organization 200. The
message says when you can continue.

More: [Invitations, Inviting](../organizations/invitations.md#inviting)

### Do refused invitations count toward the hourly limits?

Some do. An invitation refused because the address is a member, a workspace
is not valid, or an admin resends a pending owner invitation still counts.
One refused because a member invites, an admin invites as owner, or the
address is malformed does not.

More: [Invitations, Edge cases](../organizations/invitations.md#edge-cases)

### How is the hour of the invitation limit counted?

From the first counted invitation. It does not slide, and refused attempts
do not extend it.

More: [Invitations, Limits](../organizations/invitations.md#limits)

### What does `TOKEN_INVALID` mean for an invitation?

The link is unknown, expired, used, replaced by a resend, revoked, of a
deleted organization, or its inviter may no longer send it. Open the newest
invitation email, or ask for a new invitation.

More: [Invitations, Errors](../organizations/invitations.md#errors)

### Why does a bad invitation link not say whether it expired or was revoked?

All of them answer `400 TOKEN_INVALID`, with no hint which it was. The
answer must not reveal which links ever existed.

More: [Invitations, What a link shows before it is accepted](../organizations/invitations.md#what-a-link-shows-before-it-is-accepted)

### What does "Enter a valid email address." mean in the invite dialog?

The address is not an email address. It needs something before one `@` and
something after it, with no spaces.

More: [Invitations, Inviting](../organizations/invitations.md#inviting)

### What does "Choose workspaces of this organization." mean?

A chosen workspace is no longer a live workspace of the organization, for
example because it was deleted while the dialog was open.

More: [Invitations, Inviting](../organizations/invitations.md#inviting)

### What does `503 UNAVAILABLE` with reason `EMAIL_UNAVAILABLE` mean when I invite?

Email cannot be sent right now. No invitation is stored. Try again later.

More: [Invitations, Errors](../organizations/invitations.md#errors)

### What does `409 CONFLICT` mean when an invitation is accepted?

The account is already a member of the organization. The message reads "you
are already a member of this organization". Nothing changes and the link
stays usable.

More: [Invitations, Errors](../organizations/invitations.md#errors)

### How long can the invited email address be?

At most 320 characters.

More: [Invitations, Limits](../organizations/invitations.md#limits)

### In which order are the checks made when an invitation is sent?

Sign-in, the organization, the shape of the request, your role, the
address, the number of workspaces, the hourly limits, the workspaces
themselves, and last whether the address belongs to a member. The first
that fails decides the answer.

More: [Invitations, Sending an invitation](../organizations/invitations.md#sending-an-invitation)

### What does `429 RATE_LIMITED` tell me when I invite?

An hourly limit was reached. `Retry-After` and `details.retryAfterSeconds`
say when the hour ends. Wait, then send again.

More: [Invitations, Errors](../organizations/invitations.md#errors)

## The API and agents

### Can an agent send or accept invitations?

No. Invitations need a person signed in with a browser. A credential gets
`403 FORBIDDEN` with `details.reason` `SESSION_REQUIRED`.

More: [Invitations, For agents](../organizations/invitations.md#for-agents)

### Is there an MCP tool for invitations?

No. No invitation operation is open to a credential and none is an MCP
tool.

More: [Invitations, For agents](../organizations/invitations.md#for-agents)

### What can an agent do when it needs a person added?

It asks an owner or admin to invite them. It can check the result
afterwards with `organizations_members_list` or `workspaces_members_list`.

More: [Invitations, What an agent can do instead](../organizations/invitations.md#what-an-agent-can-do-instead)

### What does the request to create an invitation look like?

`POST /v1/organizations/{organizationID}/invitations` with `email`, `role`
and, optionally, `workspaceIDs`. `workspaceIDs` may be left out; it then
counts as empty. It needs a browser session.

More: [Invitations, Create](../organizations/invitations.md#create)

### What does the API return for a new invitation?

`201` with `id`, `email`, `role`, `workspaceIDs`, `invitedBy`, `createdAt`,
`expiresAt` and `resent`.

More: [Invitations, Create](../organizations/invitations.md#create)

### Is the invitation link in the API answer?

No. The link's secret is never in an API answer. It exists only in the
email.

More: [Invitations, Create](../organizations/invitations.md#create)

### What does `GET /v1/invitations/{token}` return?

`200` with exactly `email`, `organizationName`, `inviterName` and `role`.
`{token}` is the `token` value of the emailed link.

More: [Invitations, Preview](../organizations/invitations.md#preview)

### Does previewing an invitation need a sign-in or a credential?

No. The preview is public. Anyone who holds a link can open it, signed in
or not.

More: [Invitations, For agents](../organizations/invitations.md#for-agents)

### What does accepting an invitation return in the API?

`200` with the list of the organization's workspaces the account now
reaches, each with `id`, `name`, `organizationID`, `organizationName` and
`role`. The list is empty when the invitation gave no workspace.

More: [Invitations, Accept](../organizations/invitations.md#accept)

### How are pending invitations listed through the API?

`GET /v1/organizations/{organizationID}/invitations` with `limit` (1 to
100, default 50) and `cursor`, from a browser session. The entries have the
same fields as a new invitation, without `resent`.

More: [Invitations, List](../organizations/invitations.md#list)

### Is there a record of invitations being sent, revoked and accepted?

Yes. The audit trail records `invitation.created`, `invitation.revoked` and
`invitation.accepted`. There is no page that lists the trail; the pending
list shows who invited each address that has not accepted yet.

More: [Audit trail, Members and invitations](../reference/audit-trail.md#members-and-invitations)
