Connecting software to the REST API uses an API key, not a sign-in. See API keys to create one and API authentication for the request header.
Create an account
1
Fill in the sign-up form
Click Sign up on the sign-in screen and enter your Full Name, Email, Password (at least 10 characters), and Company Name. The company name is filled in from your email domain; change it if it is wrong. It becomes the account name your teammates see when you invite them. If a human verification check appears above the button, complete it; Sign Up stays disabled until you do. Click Sign Up. If you arrived from Sign up to use this template in the template gallery, the form names that template, and the welcome screen you see after you first sign in offers it.
2
Confirm your email
Terminus sends a confirmation link to your address. Click it to activate your account, then sign in. You cannot sign in until your email is confirmed. If the email does not arrive, use Resend confirmation email on the check-your-email screen.
Sign in
Signing in is a two-step, email-first flow:1
Enter your email
Type your email and click Continue. Terminus checks whether your email’s domain has single sign-on set up.
2
Enter your password, or continue with SSO
If your domain does not use SSO, the password field appears. Type your password and click Sign In. If your domain uses SSO, Terminus sends you to your identity provider to sign in there instead.
Single sign-on
When your email domain has SSO set up, Continue always sends you to your identity provider. Account owners and admins can still sign in with a password even when the account enforces SSO, so they have a way in if the identity provider is down. To do that, click Use a password instead on the sign-in screen before you click Continue. For a member at a domain that enforces SSO, the password route still ends at the identity provider. SSO is set up by an account admin and requires the Enterprise plan. See Single sign-on.Two-factor authentication
If you have turned on two-factor authentication, signing in with your password takes you to a Two-factor authentication screen:- Open your authenticator app and enter the 6-digit code it shows for Terminus Hub.
- Click Verify.
Use a backup code
When you set up two-factor authentication you saved 10 backup codes. If you do not have your authenticator app, click Use a backup code on the code screen and enter one of them (they look like3f2a6-37d2d). Each backup code works once. Click Use your authenticator app to switch back.
If you lose your authenticator and your backup codes
Ask an owner or admin of your account to reset your two-factor authentication. The reset signs you out everywhere and emails you. You then sign in with only your password, and if the account requires two-factor authentication you set it up again before you can continue. See Team members for how admins reset a member. Admins cannot reset the account owner’s two-factor authentication, so if you are the owner, keep your backup codes somewhere safe.When your account requires two-factor authentication
An account admin can require two-factor authentication for everyone in the account (see Security). If you have not set it up yet, signing in takes you to a setup screen instead of the app: confirm your password, scan the QR code with your authenticator app, enter the code it shows, then save your backup codes and tick I saved these codes. From that screen you can also Switch account or Sign out. Members who signed in through the account’s SSO are not asked to set it up.Accept an invitation
When a teammate invites you, you get an email with a link. The link opens a page titled Account <name> invites you to join, which also shows the role you are being given.- If you are new to Terminus Hub, enter your Full Name and a Password (your email is already filled in from the invitation) and click Sign Up and Accept. You do not need to confirm your email separately; the invitation link already proves it.
- If you already have a Terminus Hub login, click Sign in first, sign in, and you return to the invitation. Then click Proceed as <your name>.
If you cannot sign in
It says my email or password is invalid, but I'm sure they're right
It says my email or password is invalid, but I'm sure they're right
For security, a wrong password, an unknown email, and a locked account all show the same message. Check for typos, see the locked-account answer below, or click Forgot password? on the password step and then Send reset link to get a reset email. Reset links expire after 6 hours.
My account is locked
My account is locked
After 5 failed attempts your account locks for 15 minutes. Wrong two-factor codes count toward the same limit as wrong passwords. Wait 15 minutes, or use the unlock link Terminus emails you.
I never confirmed my email
I never confirmed my email
You cannot sign in until your email is confirmed. Signing in shows a banner with a resend option, or use Resend confirmation email on the check-your-email screen to get a fresh link.
It sends me to my identity provider, but I'm an admin
It sends me to my identity provider, but I'm an admin
Your domain has single sign-on set up. Click Use a password instead before Continue to get the password field. Owners and admins can always sign in with a password.
My sign-in session expired on the code screen
My sign-in session expired on the code screen
You took longer than 10 minutes to enter your two-factor code. Sign in again with your password and enter a fresh code.
Related
Quickstart
Sign up and run the full Terminus Hub flow.
Profile
Change your password and turn on two-factor authentication.
Security
Require two-factor authentication for your whole account.
API keys
Authenticate software against the REST API.