Admin Portal Access

Symptoms

• Clicking “Sign In” at the admin portal returns an error or the magic link does not arrive.
• The magic link email arrives but clicking the link shows “link expired” or “invalid token”.
• You can log in but the portal shows no team data or an empty seat list.
• Team members report they cannot use the invite token you generated.

The admin portal is only available on the Team tier. Solo and Pro users do not have access to the portal.

---

Likely Causes

Cause	Indicator
Signing in with the wrong email address	”No account found” error
Magic link expired (15-minute validity window)	“Link expired” or “invalid token” error
Magic link email in spam or promotions folder	No email received after 2-3 minutes
Using a Pro or Solo license email	Portal shows “Team feature not available”
Invite token expired (24-hour validity)	Team member reports “token invalid”

---

Step-by-Step Fix

Step 1: Use the correct email address

The admin portal authenticates via the email address used for the original Team subscription purchase. This is the email in the Stripe receipt.

If you are unsure which email was used:

forge license

The output shows the masked email associated with your license:

License: Team (admin)
Email:   a***[email protected]

Use this email for portal sign-in.

Step 2: Request a new magic link

Magic links expire after 15 minutes. If your link has expired:

1. Return to the admin portal sign-in page.
2. Enter your email address again.
3. Click “Send magic link”.
4. Open the new email within 15 minutes and click the link.

Do not click the old link — once a new one is requested, previous links are invalidated.

Step 3: Check spam and promotions folders

The magic link email comes from [email protected]. Check:

• Spam / Junk folder
• Promotions or Updates folder (Gmail)
• Any email filters that redirect automated email

If you find the email in spam, mark it as “not spam” so future magic links are delivered to your inbox.

Step 4: Verify Team tier and admin status

Only the first seat on a Team subscription (the purchasing account) has admin portal access. Regular team member seats have the team_id field in their license but not the admin_portal feature flag.

Check your license:

forge license

Admin output includes:

Features: ..., admin_portal

If admin_portal is not listed, your seat is a regular team member seat, not the admin seat. Contact the team admin (the person who originally purchased the subscription) for portal access.

Step 5: Regenerate invite tokens for team members

Invite tokens expire after 24 hours. If a team member reports their token is invalid:

1. Log into the admin portal.
2. Go to the Team Members section.
3. Click “Resend Invite” for the affected member.

The new token is sent directly to the member’s email address. They run:

forge activate --team <new-invite-token>

Step 6: Verify seat count

If the portal shows a seat is already taken and you need to add a new member, check your subscription’s seat count in the portal. If all seats are in use, either:

• Deactivate an existing member’s seat (they run forge deactivate)
• Upgrade the seat count by contacting support or through the Stripe Customer Portal

---

When to Escalate

Contact support at [email protected] if:

• Magic link emails consistently do not arrive after checking all folders.
• You believe you are the admin but admin_portal is not in your license features.
• Portal shows stale data (seat assignments that do not match current team members).

Include:

• The email address you are attempting to sign in with (or its masked form from forge license).
• The output of forge license.