# Signing up and verifying your email

Questions about creating a Talewright account, sign-up by invitation, the
verification email and what an unverified account can do. The rules are in
[Sign-up and email verification](../accounts/sign-up.md).

## Creating an account

### How do I create a Talewright account?

Open `https://app.usetalewright.com/sign-up`, fill in "Full name", "Email" and
"Password", and choose "Create account". You are signed in at once. The
sign-in page links to the same form with "Create account".

More: [Sign-up and email verification, The sign-up page](../accounts/sign-up.md#the-sign-up-page)

### What do I need to sign up for Talewright?

Three values: your full name, an email address and a password. Nothing else is
asked.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### Do I need a credit card to sign up?

No. Sign-up takes three values: full name, email address and password.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### Can I use Talewright right after signing up?

Yes. A new account is signed in at once and can work at once. It can create
organizations, upload files and invite people before its email is verified.

More: [Sign-up and email verification, Summary](../accounts/sign-up.md#summary)

### Do I have to confirm my email before my account is created?

No. A new address creates the account at once. A verification email goes to
the address, and the account is unverified until you open its link.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### How long am I signed in after creating my account?

30 days, in the browser that signed up.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### Where do I land after creating my account?

On "Set up your organization", when the account has no organization yet. A
sign-up that began from another page, such as an invitation, returns there.

More: [Sign-up and email verification, After "Create account"](../accounts/sign-up.md#after-create-account)

### Is a Talewright account for one person or for a whole company?

One person. An account is a name, an email address and a password. Companies
are organizations, which a person creates or joins with their account.

More: [Sign-up and email verification, Summary](../accounts/sign-up.md#summary)

### Can I create an account without belonging to an organization?

Yes. An account with no organization lands on "Set up your organization" after
sign-up.

More: [Sign-up and email verification, After "Create account"](../accounts/sign-up.md#after-create-account)

### Can I have more than one Talewright account?

Yes, one per email address. Two different addresses are two separate accounts.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### Can two accounts share one email address?

No. Addresses are unique, without regard to upper and lower case.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### What happens if I double-click "Create account"?

One request is sent. The sign-up form sends one request at a time, so a double
click does not create a second request.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### What happens if I open the sign-up page while I am signed in?

You do not see the form. The browser is sent on to the app, or to the page it
was heading for.

More: [Sign-up and email verification, The sign-up page](../accounts/sign-up.md#the-sign-up-page)

### What does "Already have an account? Sign in" do on the sign-up page?

It opens the sign-in page. Use it when your address already has an account.

More: [Sign-up and email verification, The sign-up page](../accounts/sign-up.md#the-sign-up-page)

### Can I see the password I am typing on the sign-up page?

Yes. The password field has a button that shows the password and hides it
again.

More: [Sign-up and email verification, The sign-up page](../accounts/sign-up.md#the-sign-up-page)

## Email address rules

### Which email addresses can I sign up with?

Any address with exactly one `@`, text on both sides of it, no spaces or
control characters and at most 320 characters. Nothing else is checked.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### Are Ada@Example.com and ada@example.com the same account?

Yes. Addresses are compared without regard to upper and lower case. The
address is stored and shown as it was typed.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### Can I sign up with a plus address such as ada+files@example.com?

Yes. It counts as its own address: `ada+files@example.com` and
`ada@example.com` are two different addresses and can be two accounts.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### Does Talewright ignore dots in the part of my address before the @?

No. Only upper and lower case are ignored. Nothing else in an address is
normalized.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### Does Talewright check that my email domain exists when I sign up?

No. The domain does not have to exist and no test message is sent first.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### What is the longest email address I can sign up with?

320 characters.

More: [Sign-up and email verification, Limits](../accounts/sign-up.md#limits)

### What happens if I type spaces before or after my email address?

They are removed and sign-up continues. A space inside the address is refused.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### Why do I get "Enter a valid email address." on the sign-up page?

The address cannot be an address: it has a space inside, two `@` signs,
nothing before or after the `@`, or more than 320 characters.

More: [Sign-up and email verification, The sign-up page](../accounts/sign-up.md#the-sign-up-page)

### I typed the wrong email address when I signed up. How do I fix it?

Change it under Settings, "Security", in the section "Email". Confirming the
new address from its inbox verifies the account.

More: [Password and email address, Changing the email address](../accounts/password-and-email.md#changing-the-email-address-1)

## Password rules

### What are the password requirements?

12 to 128 characters. Any characters are allowed and every character counts,
spaces included.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### Does my password need a number, a capital letter or a symbol?

No. There is no rule about letters, digits or symbols. The only rule is
length.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### What is the longest password I can use?

128 characters. A longer one is refused with "Use 128 characters or fewer."

More: [Sign-up and email verification, Limits](../accounts/sign-up.md#limits)

### Can my password contain spaces?

Yes. Spaces count like any other character, also at the start and the end. The
password is never trimmed, so sign-in must use the same spaces.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### Can I use emoji or accented letters in my password?

Yes. Length is counted in Unicode code points, so some emoji count as more
than one character.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### Why do I get "Use at least 12 characters." when I sign up?

The password has fewer than 12 characters. The hint under the field says "At
least 12 characters."

More: [Sign-up and email verification, The sign-up page](../accounts/sign-up.md#the-sign-up-page)

### Can I use a password generated by a password manager?

Yes, when it has 12 to 128 characters. Any characters are accepted.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### Is a password made only of spaces accepted?

Yes, if it has 12 to 128 of them. The only rule is length.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### Does Talewright check my password against lists of leaked passwords?

No. The only rule for a password is its length.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

## Your name

### What can I enter as my full name?

1 to 200 characters, after spaces at both ends are removed. Control characters
are refused. A name made only of spaces is refused.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### Does Talewright check that I use my real name?

No. Only the length is checked, and that the name holds no control characters.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### Why do I get "Enter your name, up to 200 characters."?

The name is empty, made only of spaces, longer than 200 characters or holds a
control character.

More: [Sign-up and email verification, The sign-up page](../accounts/sign-up.md#the-sign-up-page)

### What happens to spaces or a line break at the end of my name?

They are removed and the rest is kept.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

## When the address already has an account

### What happens if I sign up with an email address that already has an account?

Nothing is created and nobody is signed in. The page shows "Check your email",
and the holder of the address gets the email "You already have a Talewright
account".

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### Why does the sign-up page say "Check your email" instead of signing me in?

The address already has an account. Talewright emailed that address instead of
creating a second account. Sign in, or use "Forgot password?" on the sign-in
page.

More: [Sign-up and email verification, After "Create account"](../accounts/sign-up.md#after-create-account)

### What does the email "You already have a Talewright account" mean?

Someone, perhaps you, tried to sign up with your address. No new account was
created and yours was not changed. The email has a "Sign in" button and a link
to reset the password.

More: [Sign-up and email verification, Emails this feature sends](../accounts/sign-up.md#emails-this-feature-sends)

### I got "You already have a Talewright account" but I did not try to sign up. Is my account at risk?

No. The attempt created nothing, signed nobody in and did not change your
account. You can ignore the email.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### Does signing up again with my address change my existing password?

No. The password and name typed in the second sign-up are discarded. The
existing account is not changed.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### What does "Use a different email" do on the sign-up page?

It returns to the form. The name and password you typed are kept and the
address is selected, so you only correct the address.

More: [Sign-up and email verification, After "Create account"](../accounts/sign-up.md#after-create-account)

### Can someone find out whether I have an account by signing up with my address?

Yes. A new address signs in at once and a taken one does not, so the person at
the keyboard can tell. You get an email about it, and the attempt limits bound
how often anyone can ask.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

### How often is the email "You already have a Talewright account" sent?

At most once per account in 15 minutes, however many times someone tries.

More: [Sign-up and email verification, Limits](../accounts/sign-up.md#limits)

### I signed up twice by mistake. Do I have two accounts now?

No. The first sign-up created the account. The second got the answer for a
taken address, and the account got one "You already have a Talewright account"
email.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### I signed up, never verified, and now sign-up says "Check your email". How do I get into the account?

Use "Forgot password?" on the sign-in page. A reset from the emailed link sets
a new password, verifies the address and ends every session of the account.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### What happens when two sign-ups for the same new address arrive at the same moment?

One account is created. One of them is signed in. The others get the answer
for a taken address.

More: [Sign-up and email verification, Creating an account](../accounts/sign-up.md#creating-an-account)

## Closed sign-up

### What does "Sign-up is by invitation" mean?

Sign-up is closed to your address. The form stays filled in and adds "To
create an account, open the link in your invitation email."

More: [Sign-up and email verification, Closed sign-up](../accounts/sign-up.md#closed-sign-up)

### What is closed sign-up?

A mode in which only listed addresses and people with an invitation can create
accounts. Sign-up runs either open to everyone or closed like this.

More: [Sign-up and email verification, Closed sign-up](../accounts/sign-up.md#closed-sign-up)

### How do I get an account while sign-up is closed?

Ask an owner or admin of an organization to invite you. Open the link in the
invitation email and choose "Create account".

More: [Sign-up and email verification, Errors](../accounts/sign-up.md#errors)

### Who is on the sign-up allowlist?

Exact addresses and whole domains. Both are compared without regard to upper
and lower case.

More: [Sign-up and email verification, Closed sign-up](../accounts/sign-up.md#closed-sign-up)

### My company's domain is allowed. Can I sign up with an address at a subdomain?

No. A listed domain admits addresses directly at that domain. With
`example.com` listed, `ada@example.com` may sign up and `ada@mail.example.com`
may not. A lookalike such as `notexample.com` is not admitted either.

More: [Sign-up and email verification, Closed sign-up](../accounts/sign-up.md#closed-sign-up)

### Does an allowlisted address need an invitation?

No. It goes through sign-up exactly as it would while sign-up is open.

More: [Sign-up and email verification, Closed sign-up](../accounts/sign-up.md#closed-sign-up)

### I was invited, but sign-up still says "Sign-up is by invitation". Why?

The sign-up must start from your invitation link, in the same browser, and use
the invited address. An expired, revoked or replaced invitation does not
count. Open the newest invitation email and choose "Create account" there.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### Can I use a colleague's invitation link to sign up with my own address?

No. An invitation admits only the address it was sent to.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### Does closed sign-up stop me from signing in to my existing account?

No. People who already have an account sign in, and accept invitations, as
always.

More: [Sign-up and email verification, Closed sign-up](../accounts/sign-up.md#closed-sign-up)

### Does "Sign-up is by invitation" tell me whether my address has an account?

No. The refusal is the same whether or not the address already has an account.
It creates nothing, emails nobody and signs nobody in.

More: [Sign-up and email verification, Closed sign-up](../accounts/sign-up.md#closed-sign-up)

### Do sign-ups refused because sign-up is closed count toward the attempt limit?

Yes. They count toward the limit of 100 sign-up attempts per client address in
15 minutes.

More: [Sign-up and email verification, Closed sign-up](../accounts/sign-up.md#closed-sign-up)

### Why do I get `VALIDATION_FAILED` and not `SIGNUP_CLOSED` while sign-up is closed?

The fields are checked first. A request with an invalid email, password or
name gets `422 VALIDATION_FAILED`. Only a well-formed request learns that
sign-up is closed.

More: [Sign-up and email verification, Closed sign-up](../accounts/sign-up.md#closed-sign-up)

### What does the API answer when sign-up is closed to an address?

`403 SIGNUP_CLOSED` with the message "Sign-up is by invitation".

More: [Sign-up and email verification, Errors](../accounts/sign-up.md#errors)

## Signing up from an invitation

### How do I create an account from an invitation email?

Follow these steps:

- open the link in the email, which shows the invitation page;
- choose "Create account";
- enter your name and a password and choose "Create account";
- back on the invitation, choose "Accept invitation".

The email field already holds the invited address.

More: [Sign-up and email verification, Signing up from an invitation](../accounts/sign-up.md#signing-up-from-an-invitation)

### Why can I not change the email address on the sign-up form?

You opened the form from an invitation. It is filled in with the invited
address, which cannot be changed there, because an invitation is for one
address.

More: [Sign-up and email verification, Signing up from an invitation](../accounts/sign-up.md#signing-up-from-an-invitation)

### Why does the sign-up page say "Join {organization} on Talewright"?

You came from an invitation. The heading names the organization that invited
you instead of "Create your account".

More: [Sign-up and email verification, The sign-up page](../accounts/sign-up.md#the-sign-up-page)

### Why did I get no verification email after signing up from an invitation?

None is sent for a sign-up that carries a live invitation to its address.
Accepting the invitation verifies the address, because the invitation link was
sent to that inbox.

More: [Sign-up and email verification, Signing up from an invitation](../accounts/sign-up.md#signing-up-from-an-invitation)

### Does accepting an invitation verify my email address?

Yes. Until you accept, the new account is unverified like any other new
account.

More: [Sign-up and email verification, Other ways an email becomes verified](../accounts/sign-up.md#other-ways-an-email-becomes-verified)

### Does creating my account from an invitation accept the invitation?

No. Signing up does not use the invitation up. After sign-up you are back on
the invitation, signed in, and "Accept invitation" joins the organization.

More: [Sign-up and email verification, Signing up from an invitation](../accounts/sign-up.md#signing-up-from-an-invitation)

### I created my account from an invitation and never accepted it. Is my email verified?

No. The account exists and is unverified, and no verification email was sent.
"Resend verification email" sends one.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### My invitation was revoked after I created my account. What happens to the account?

It stays. It is unverified and belongs to no organization. You can verify it
with "Resend verification email" and use it on its own. If it stays
unverified and empty, it is removed 30 days after sign-up.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### I already have an account. Should I create a new one from the invitation?

No. Choose "Sign in" on the invitation page. Signing up again with the same
address gets the answer for a taken address.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### Can I accept an invitation with an account whose email is not verified?

Yes. Accepting needs a session whose email is the invited address. The email
may be verified or not.

More: [Sign-up and email verification, Signing up from an invitation](../accounts/sign-up.md#signing-up-from-an-invitation)

### I opened an invitation and then signed up with a different email address. What happens?

The invitation does not match the address, so it is ignored. While sign-up is
open you get an ordinary sign-up. While it is closed you get `SIGNUP_CLOSED`.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### My invitation expired before I created my account. Can I still sign up from its link?

No. The link of an expired, revoked or already accepted invitation admits
nothing. You need the newest invitation email. While sign-up is open you can
still sign up the ordinary way.

More: [Sign-up and email verification, Signing up from an invitation](../accounts/sign-up.md#signing-up-from-an-invitation)

## Verifying your email address

### How do I verify my email address?

Open the email with the subject "Verify your email for Talewright" and choose
the button "Verify your email". In the browser that signed up, or one signed
in to the account, the app opens with the message "Email verified".

More: [Sign-up and email verification, Verifying the email address](../accounts/sign-up.md#verifying-the-email-address)

### Why does Talewright ask me to verify my email?

Verification proves that you control the address. Only a few actions wait for
it: deleting a workspace or an organization, and setting file statuses
through an API key or connected app. An account that never verifies and holds
nothing is removed 30 days after sign-up.

More: [Sign-up and email verification, Summary](../accounts/sign-up.md#summary)

### How long is the verification link valid?

24 hours. It works once, and only the newest link works.

More: [Sign-up and email verification, Limits](../accounts/sign-up.md#limits)

### What does the verification email look like?

Its subject is "Verify your email for Talewright". It starts with "Hi {full
name}," and has a button "Verify your email". It says "For security, this link
expires in 24 hours."

More: [Sign-up and email verification, Emails this feature sends](../accounts/sign-up.md#emails-this-feature-sends)

### Why does the verification link ask me to choose a password?

The browser that opened it is not signed in to the account and is not the
browser that created it. That covers another device, another browser, a mail
app's built-in browser, and a browser whose cookies were cleared. It is
deliberate: a link opened in a stranger's browser never signs that browser in
to your account.

More: [Sign-up and email verification, Verifying the email address](../accounts/sign-up.md#verifying-the-email-address)

### What happens when I choose a password from the verification link?

Setting it:

- verifies the email;
- replaces the password chosen at sign-up;
- ends every session of the account, on every device;
- makes every other emailed link of the account invalid;
- revokes every API key and connected app of the account.

It signs nobody in. You then sign in with the new password.

More: [Sign-up and email verification, Verifying the email address](../accounts/sign-up.md#verifying-the-email-address)

### I signed up on my laptop and opened the verification link on my phone. What happens?

The phone shows "Choose a password". Setting one verifies the email and signs
the laptop out, because the phone is neither signed in to the account nor the
browser that signed up.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### Does the verification link work in a private or incognito window?

It opens, but it shows "Choose a password" instead of verifying at once. A
private window is neither signed in to the account nor the browser that signed
up.

More: [Sign-up and email verification, Verifying the email address](../accounts/sign-up.md#verifying-the-email-address)

### I signed up, signed out and then opened the verification link. Am I signed in?

Yes, in the same browser. The email is verified and the browser is signed in,
because it is remembered as the browser that signed up.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### How long does Talewright remember the browser I signed up in?

30 days. During that time the emailed link can sign that browser in, even
after it signed out.

More: [Sign-up and email verification, Limits](../accounts/sign-up.md#limits)

### Does verifying my email sign me out?

No, when the link verifies directly: the session stays as it is. Only choosing
a password from the link ends every session.

More: [Sign-up and email verification, Verifying the email address](../accounts/sign-up.md#verifying-the-email-address)

### Can I use the verification link twice?

No. The first use verifies. The second is a dead link: "Email already
verified" in a browser signed in to the verified account, "Link expired or
invalid" elsewhere.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### What does "Link expired or invalid" mean on the verification page?

The link is unknown, more than 24 hours old, already used or replaced by a
newer one. The page never says which. Enter your email there and choose "Send
a new link".

More: [Sign-up and email verification, The verification page](../accounts/sign-up.md#the-verification-page)

### Why does only the newest verification email work?

Asking for a new link makes every earlier one invalid. Open the most recent
email.

More: [Sign-up and email verification, Verifying the email address](../accounts/sign-up.md#verifying-the-email-address)

### What does "Email already verified" mean?

You opened a dead verification link in a browser that is signed in to a
verified account. Nothing needs to be done. "Continue to Talewright" opens the
app.

More: [Sign-up and email verification, The verification page](../accounts/sign-up.md#the-verification-page)

### How do I know that verification worked?

The app opens at its start page with the message "Email verified", and the
"Verify your email" reminder is gone.

More: [Sign-up and email verification, The verification page](../accounts/sign-up.md#the-verification-page)

### What does "Could not verify your email" mean?

The verification did not go through. The page shows "Too many attempts. Try
again in 4 minutes." (the time varies) or "Something went wrong. Try again.",
with the button "Try again".

More: [Sign-up and email verification, The verification page](../accounts/sign-up.md#the-verification-page)

### I got a verification email but never signed up. What should I do?

You can ignore it. Someone created an account with your address, and it stays
unverified unless the link is opened.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### Someone created an account with my email address. How do I take it over?

Open the verification link in your own browser and choose a password. Their
password stops working, their sessions end and their API keys and connected
apps are revoked. The account is then yours alone.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### What does "You are signed in as {address}. This link is for another account." mean?

The browser is signed in to a different account than the one the link
verifies. A password set there replaces the other account's password and signs
that account out on every device. The browser stays signed in to its own
account.

More: [Sign-up and email verification, The verification page](../accounts/sign-up.md#the-verification-page)

### I typed a too-short password on "Choose a password". Is my link used up?

No. The problem is reported under "New password" and the link keeps working.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### Where do I end up after choosing a password from the verification link?

On the sign-in page, with "Email verified" and "Sign in with your new
password." A browser signed in to a different account opens the app instead,
with the message "Email verified".

More: [Sign-up and email verification, The verification page](../accounts/sign-up.md#the-verification-page)

### Does opening a verification link a second time change the verification date?

No. Verifying a second time changes nothing. The date of the first
verification is kept.

More: [Sign-up and email verification, Verifying the email address](../accounts/sign-up.md#verifying-the-email-address)

### In what other ways does my email become verified?

Three:

- a password reset from an emailed link;
- accepting an invitation sent to the address;
- confirming an email change, which verifies the new address.

More: [Sign-up and email verification, Other ways an email becomes verified](../accounts/sign-up.md#other-ways-an-email-becomes-verified)

### I changed my email address before verifying the first one. Does the old verification link still work?

Until the change is confirmed, yes. Confirming the change verifies the new
address and makes the old link invalid.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### Why did my verification link stop working after I reset my password?

The reset verified the address itself and made the outstanding link invalid. A
confirmed email change or an accepted invitation does the same.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### Why does the link disappear from the address bar on the verification page?

The page reads the token and removes it from the address bar and the browser
history before it does anything else.

More: [Sign-up and email verification, The verification page](../accounts/sign-up.md#the-verification-page)

### Can I verify my email with a code instead of a link?

No. Verification uses the link in the email. A password reset, an accepted
invitation or a confirmed email change also verify the address.

More: [Sign-up and email verification, Verifying the email address](../accounts/sign-up.md#verifying-the-email-address)

### Why did my API keys stop working after I verified my email?

You chose a password from the verification link in another browser than the
one that signed up. That revokes every API key and connected app of the
account.

More: [Sign-up and email verification, Verifying the email address](../accounts/sign-up.md#verifying-the-email-address)

### The browser I signed up in is now signed in to another account. What does the verification link do there?

It verifies the new account and signs the browser in to it. The other
account's session in that browser is ended in the same step.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### Does the verification link still work after the account was deleted?

No. It is a dead link.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

## Getting a new verification email

### Why didn't I get the verification email?

Check the address shown in the "Verify your email" reminder, then choose
"Resend verification email". If the address is wrong, change it under
Settings, "Security". An account created from an invitation gets no
verification email at sign-up.

More: [Sign-up and email verification, The reminder](../accounts/sign-up.md#the-reminder)

### How do I resend the verification email?

Choose "Resend verification email" in the "Verify your email" reminder in the
app's navigation. The app answers "Verification email sent. Check your inbox."

More: [Sign-up and email verification, The reminder](../accounts/sign-up.md#the-reminder)

### Why is the "Resend verification email" button greyed out?

It stays disabled for 30 seconds after each send.

More: [Sign-up and email verification, The reminder](../accounts/sign-up.md#the-reminder)

### How many verification emails can I request?

10 for one email address in 15 minutes, and 100 from one client address in 15
minutes.

More: [Sign-up and email verification, Limits](../accounts/sign-up.md#limits)

### My verification link expired. How do I get a new one?

Signed in, choose "Resend verification email". Signed out, open the old link
or `https://app.usetalewright.com/verify-email`, enter your email on the page
"Link expired or invalid" and choose "Send a new link".

More: [Sign-up and email verification, Asking for a new link](../accounts/sign-up.md#asking-for-a-new-link)

### I chose "Send a new link" and no email came. Why?

Only an unverified account gets an email. The page shows "If {address} has an
account waiting for verification, we sent it a new link." whether the address
has an unverified account, a verified account or no account.

More: [Sign-up and email verification, Asking for a new link](../accounts/sign-up.md#asking-for-a-new-link)

### Does asking for a new verification link reveal whether an address has an account?

No. The answer is the same for an unverified account, a verified account and
no account.

More: [Sign-up and email verification, Asking for a new link](../accounts/sign-up.md#asking-for-a-new-link)

### What does "Too many requests. Try again in 4 minutes." mean when I resend the verification email?

The limit on requests for a new link was reached. Wait for the time shown,
which varies.

More: [Sign-up and email verification, The reminder](../accounts/sign-up.md#the-reminder)

### What does "Could not send the email. Try again." mean?

The resend failed for another reason than the request limit. Choose "Resend
verification email" again.

More: [Sign-up and email verification, The reminder](../accounts/sign-up.md#the-reminder)

### Which address does "Resend verification email" send to?

The account's current address.

More: [Sign-up and email verification, Asking for a new link](../accounts/sign-up.md#asking-for-a-new-link)

### The button in a Talewright email does not work. What can I do?

Copy the link printed below the button and paste it into your browser. The
verification, password reset and email confirmation emails print the full link
after "If the button does not work, copy and paste this link into your
browser:".

More: [Sign-up and email verification, Emails this feature sends](../accounts/sign-up.md#emails-this-feature-sends)

### What happens if I press "Resend verification email" twice quickly?

One request is sent, because each send would make the previous link invalid.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

## Before your email is verified

### What can I do before I verify my email?

Almost everything. An unverified account can sign in and out, create
organizations and workspaces, upload and manage files, create API keys,
connect apps, invite teammates, accept invitations, change its name and
password, start an email change and manage its sessions.

More: [Sign-up and email verification, What an unverified account can and cannot do](../accounts/sign-up.md#what-an-unverified-account-can-and-cannot-do)

### What can I not do until my email is verified?

Delete a workspace or delete an organization. And an API key or connected app
that acts for you cannot set file statuses. Deleting your own account works
without verifying.

More: [Sign-up and email verification, What an unverified account can and cannot do](../accounts/sign-up.md#what-an-unverified-account-can-and-cannot-do)

### Does an unverified account expire?

Only while it is empty. An account that never verified its email and holds
nothing is removed 30 days after sign-up. One that holds a file, a folder, an
upload in progress, another member, a pending invitation, an API key, a
connected app, a membership in someone else's organization or a pending email
change is kept, however old it is.

More: [Deleting an account, Unverified accounts are removed after 30 days](../accounts/delete-account.md#unverified-accounts-are-removed-after-30-days)

### Can I sign up again after my unverified account was removed?

Yes, at once. After such a removal the address can sign up again, as after
any deletion.

More: [Sign-up and email verification, What an unverified account can and cannot do](../accounts/sign-up.md#what-an-unverified-account-can-and-cannot-do)

### Can I dismiss the "Verify your email" reminder?

Not the one in the navigation. The alert on "Set up your organization" has
"Dismiss", which hides it on that page only, and it is back the next time the
page opens. Verifying the email removes both.

More: [Sign-up and email verification, The reminder](../accounts/sign-up.md#the-reminder)

### What does the "Verify your email" icon in the navigation mean?

Your email is not verified yet. With the navigation collapsed, the reminder is
an icon labelled "Verify your email".

More: [Sign-up and email verification, The reminder](../accounts/sign-up.md#the-reminder)

### Why do I get `EMAIL_NOT_VERIFIED`?

The action needs a verified email. Deleting a workspace or an organization
answers `403 EMAIL_NOT_VERIFIED`, "Verify your email address first", until
the email is verified. Deleting your own account never answers it.

More: [Sign-up and email verification, Errors](../accounts/sign-up.md#errors)

### Why do I get `FORBIDDEN` instead of `EMAIL_NOT_VERIFIED`?

The role is checked before the email. An unverified member who is not allowed
to delete an organization anyway gets `403 FORBIDDEN`.

More: [Sign-up and email verification, What an unverified account can and cannot do](../accounts/sign-up.md#what-an-unverified-account-can-and-cannot-do)

### Do I have to sign in again after verifying before I can delete things?

No. Once the email is verified, the refused actions work at once.

More: [Sign-up and email verification, What an unverified account can and cannot do](../accounts/sign-up.md#what-an-unverified-account-can-and-cannot-do)

### Can an unverified account invite teammates?

Yes. Neither inviting nor accepting an invitation needs a verified email.

More: [Sign-up and email verification, What an unverified account can and cannot do](../accounts/sign-up.md#what-an-unverified-account-can-and-cannot-do)

### Can I set file statuses before verifying my email?

In the browser, yes, if your role allows it. Through an API key or connected
app, no: that needs the `files:approve` scope and a member whose email is
verified.

More: [Sign-up and email verification, Who can do what](../accounts/sign-up.md#who-can-do-what)

### What does "To delete this organization, first open the link we sent to {address}." mean?

The action was refused because your email is not verified. The alert is titled
"Verify your email" and has its own "Resend verification email" button. The
words after "To" name the action.

More: [Sign-up and email verification, The reminder](../accounts/sign-up.md#the-reminder)

### How can I tell whether my email is verified?

While it is unverified, the navigation shows "Verify your email" with "Open
the link we sent to {address}." Through the API, `GET /v1/me` reports
`emailVerified`.

More: [Sign-up and email verification, The reminder](../accounts/sign-up.md#the-reminder)

### What is the difference between a verified and an unverified account?

An unverified account cannot delete a workspace or an organization, and its
API keys and connected apps cannot set file statuses. It can delete itself.
It is removed 30 days after sign-up if it is still empty then. Everything
else works the same.

More: [Sign-up and email verification, What an unverified account can and cannot do](../accounts/sign-up.md#what-an-unverified-account-can-and-cannot-do)

## Attempt limits

### How many times can I try to sign up?

10 times for one email address in 15 minutes, from all clients together, and
100 times from one client address in 15 minutes.

More: [Sign-up and email verification, Limits](../accounts/sign-up.md#limits)

### What does "Too many attempts. Try again in 4 minutes." mean on the sign-up page?

A sign-up limit was reached. Wait for the time shown, which varies.

More: [Sign-up and email verification, The sign-up page](../accounts/sign-up.md#the-sign-up-page)

### What does "Something went wrong. Try again." mean on the sign-up page?

The sign-up failed for a reason other than an invalid field, too many attempts
or closed sign-up. Choose "Create account" again.

More: [Sign-up and email verification, The sign-up page](../accounts/sign-up.md#the-sign-up-page)

### Do sign-up attempts use up my sign-in attempts?

No. Each action counts separately.

More: [Sign-up and email verification, Limits](../accounts/sign-up.md#limits)

### Does a sign-up refused for a malformed field count toward the limit?

No. A request refused because a field is malformed is not counted.

More: [Sign-up and email verification, Limits](../accounts/sign-up.md#limits)

### How many verification attempts are allowed from one client address?

100 in 15 minutes.

More: [Sign-up and email verification, Limits](../accounts/sign-up.md#limits)

## Emails

### Which emails does Talewright send when I sign up?

Two kinds:

- "Verify your email for Talewright", to the new account's address, at sign-up
  without an invitation and at every request for a new link by an unverified
  account;
- "You already have a Talewright account", to the existing account's address,
  when someone signs up with an address that has an account.

More: [Sign-up and email verification, Emails this feature sends](../accounts/sign-up.md#emails-this-feature-sends)

### What happens to my sign-up when Talewright cannot send email?

Nothing is created. Sign-up answers `503 UNAVAILABLE` with reason
`EMAIL_UNAVAILABLE`, because the account and its verification email are
created together or not at all. Try again later.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

## For developers and agents

### Can a script create Talewright accounts through the API?

Yes. `POST /v1/auth/sign-up` is a public REST operation that takes `email`,
`password`, `fullName` and optionally `invitationToken`. The limits per email
address and per client address apply.

More: [Sign-up and email verification, For agents](../accounts/sign-up.md#for-agents)

### Is there an MCP tool for signing up or verifying an email?

No. No account operation is an MCP tool.

More: [Sign-up and email verification, Who can do what](../accounts/sign-up.md#who-can-do-what)

### Which API key scope lets an agent create accounts?

None. No credential scope grants any account operation. Sign-up is public and
ignores a bearer token.

More: [Sign-up and email verification, Who can do what](../accounts/sign-up.md#who-can-do-what)

### What is the difference between `201` and `202` from `POST /v1/auth/sign-up`?

`201` means the account was created and signed in: the response sets the
session cookie. `202` means the address already has an account, which was
emailed: no session and no body.

More: [Sign-up and email verification, For agents](../accounts/sign-up.md#for-agents)

### Which cookies does sign-up set?

`__Host-session`, valid for 30 days, and `__Host-signup` when the browser has
none.

More: [Sign-up and email verification, For agents](../accounts/sign-up.md#for-agents)

### How do I verify an email address through the API?

Send `POST /v1/auth/verify-email` with `token`, the `token` query parameter of
the emailed link, and optionally `newPassword`. `204` means verified.

More: [Sign-up and email verification, For agents](../accounts/sign-up.md#for-agents)

### Why does `POST /v1/auth/verify-email` answer `422` on `newPassword`?

The client is neither signed in to the account nor the one that signed up, so
it must send `newPassword` with 12 to 128 characters. The link stays usable:
send the same token again with a valid `newPassword`.

More: [Sign-up and email verification, For agents](../accounts/sign-up.md#for-agents)

### What does `TOKEN_INVALID` mean when I verify an email?

`400 TOKEN_INVALID`, "This link is invalid or has expired": the verification
link is unknown, expired, used or replaced. The answer never says which. Ask
for a new link.

More: [Sign-up and email verification, Errors](../accounts/sign-up.md#errors)

### How do I ask for a new verification link through the API?

Send `POST /v1/auth/resend-verification` with `email`. It answers `202`
whenever the address is well formed, whether or not an email is sent.

More: [Sign-up and email verification, For agents](../accounts/sign-up.md#for-agents)

### How does the API report several invalid sign-up fields at once?

It reports one, in the order email, password, full name. The form in the app
reports all of them under their fields.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### Which fields can `VALIDATION_FAILED` name at sign-up?

`email`, `password` or `fullName`, in `details.field`. A body that is not
valid JSON or lacks a required field answers `VALIDATION_FAILED` with
`details` `null`.

More: [Sign-up and email verification, Errors](../accounts/sign-up.md#errors)

### What happens if an API request signs up while it carries another account's session cookie?

The new account is created and the session cookie is replaced with the new
account's. The other account's session that the request carried is ended in
the same step.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### What happens when two requests use the same verification link at the same moment?

Exactly one succeeds.

More: [Sign-up and email verification, Edge cases](../accounts/sign-up.md#edge-cases)

### Does the verify-email response sign the client in?

Only in one case: it sets `__Host-session` when the browser that signed up was
not signed in to the account. A client that had to send `newPassword` is not
signed in.

More: [Sign-up and email verification, For agents](../accounts/sign-up.md#for-agents)
