Skip to main content

Account Setup

This guide covers everything needed to get an account operational: authentication, onboarding, profile management, and API access.

1) Sign up​

  1. Go to xmagic.ai/login
  2. Click Sign up
  3. Enter email + password
  4. Verify email from inbox link
  5. Complete initial onboarding

Password expectations​

Use a strong password with:

  • minimum length,
  • numeric characters,
  • symbols,
  • no reused credentials from other services.

Sign in / sign up screen

2) Login methods​

xMagic supports multiple sign-in options depending on workspace policy.

MethodBest for
Email + passwordStandard individual access
Google OAuthFast SSO with Google account
Microsoft OAuthEntra ID / Microsoft-based orgs
tip

Workspace admins can restrict allowed sign-in methods for compliance.

3) First-time onboarding flow​

Typical onboarding includes:

  1. Set display name
  2. Upload avatar
  3. Name workspace
  4. Confirm initial preferences

4) Profile management​

Path: Avatar → Settings → Profile

You can manage:

  • display name,
  • password,
  • API keys,
  • account deletion controls.

Profile and API key settings panel

5) API key management​

API keys allow programmatic access to xMagic endpoints.

Create key​

  1. Open Profile → API Keys
  2. Click Create new key
  3. Name the key by use case
  4. Copy key immediately (one-time visibility)

Use key​

Send in request headers as:

  • x-api-key: <your_key>

Rotate and revoke​

  • Rotate keys regularly
  • Revoke unused keys immediately
  • Use separate keys per environment/use case

6) Logout and session safety​

To sign out:

  1. Open avatar/workspace menu
  2. Click Log out

Log out option in profile menu

Recommended:

  • log out from shared devices,
  • avoid storing credentials in plain text,
  • review account activity periodically.

7) Common setup issues​

Didn’t receive verification email​

  • check spam/promotions folders,
  • confirm email address typo-free,
  • retry verification link send.

OAuth login fails​

  • confirm correct Google/Microsoft account,
  • check tenant restrictions (for Microsoft orgs),
  • ask admin if SSO method is disabled.

Can login but can’t access expected features​

Likely role privilege issue. Check Workspace → Privileges with your admin.

8) Account security best practices​

  • Use MFA if your org policy supports it
  • Prefer SSO in enterprise environments
  • Rotate passwords/API keys periodically
  • Don’t share credentials between users
  • Use least privilege for member roles

9) Invite teammates​

From Settings, use member/invite flows to onboard teammates and assign correct role privileges.

For controlled growth, define role templates before inviting large teams.