Skip to main content
Getting your Jomioz account properly configured from the start saves your team time and prevents access problems down the road. This guide walks you through every step of the account setup process — from your initial sign-up to team permissions, API key management, and securing your account with two-factor authentication.

​
Creating Your Account

Sign up for Jomioz and configure your workspace with a few quick steps.
1

Sign Up

Go to app.jomioz.com and click Sign Up. Enter your work email address and choose a strong password. Jomioz will send a verification email to the address you provide.
2

Verify Your Email

Open the verification email from Jomioz and click Confirm Email Address. You’ll be redirected back to the app to continue setup. Check your spam folder if the email doesn’t arrive within a few minutes.
3

Name Your Workspace

Enter a name for your workspace — typically your company or team name. This name appears throughout the Dashboard and in API responses. You can change it later in Workspace Settings.
4

Select a Plan

Choose the plan that fits your team’s needs. You can start with the free tier and upgrade at any time from Settings → Billing. Rate limits and feature availability vary by plan.

​
Workspace Settings

Customize how your workspace behaves to match your organization’s preferences. Navigate to Settings → Workspace in the Dashboard to access the following options:
  • Organization Name — Update the display name for your workspace. This name appears in the Dashboard header, notification emails, and API response metadata.
  • Timezone — Set a default timezone for the workspace. Jomioz uses this setting to display timestamps in the Dashboard and schedule time-based notifications.
  • Notifications — Configure which system events trigger email alerts for your workspace administrators. Toggle alerts for API errors, rate limit warnings, and billing thresholds.
  • Branding — Upload a workspace logo and set a custom color for your Dashboard theme.
Click Save Changes after updating any setting to apply your configuration.

​
Inviting Team Members

Add your colleagues to the workspace and control what each person can access.
1

Open the Team Page

In the Dashboard, go to Settings → Team. You’ll see a list of current workspace members and their assigned roles.
2

Send an Invitation

Click Invite Member. Enter the email address of the person you want to invite, select their role, and click Send Invite. Jomioz sends them an email with a link to accept the invitation and create their account.
3

Assign a Role

Each member must have exactly one role. Choose the role that matches their responsibilities.
4

Manage Existing Members

To change a member’s role, click the ⋯ menu next to their name and select Change Role. To remove someone from the workspace, select Remove Member. Removed members immediately lose access to the Dashboard and all API endpoints scoped to the workspace.

​
Managing API Keys

API keys authenticate requests to the Jomioz REST API. Each team member can generate their own keys, and Admins can view and revoke keys across the workspace.
1

Generate a New Key

Go to Settings → API Keys and click New Key. Enter a descriptive name that identifies where or how the key will be used — for example, production-backend or ci-pipeline.
2

Copy the Key

After clicking Create, copy the full API key value displayed on screen. Store it securely in a password manager or secrets manager such as AWS Secrets Manager, GCP Secret Manager, or HashiCorp Vault.
3

Use the Key in Requests

Pass the key as a Bearer token in the Authorization header of every API request.
4

Revoke a Key

To revoke an API key, go to Settings → API Keys, find the key you want to remove, and click Revoke. Confirm the action in the dialog that appears. The key is invalidated immediately.
Revoking an API key immediately breaks any integration or service that uses it. Before revoking a key, ensure you have updated all dependent systems to use a replacement key. There is no grace period — requests using a revoked key return 401 Unauthorized instantly.

​
Two-Factor Authentication

Enable two-factor authentication (2FA) to add an extra layer of security to your account. Jomioz recommends 2FA for all users, and requires it for workspace Admins.
1

Open Security Settings

Click your avatar in the top-right corner of the Dashboard and go to Account → Security.
2

Enable Two-Factor Authentication

Click Enable 2FA. Jomioz supports authentication apps that generate time-based one-time passwords (TOTP), such as Google Authenticator, Authy, or 1Password.
3

Scan the QR Code

Open your authenticator app, tap Add Account, and scan the QR code displayed in the Dashboard. The app will begin generating 6-digit codes that refresh every 30 seconds.
4

Confirm and Save Backup Codes

Enter the current 6-digit code from your authenticator app to confirm the setup. Jomioz will display a set of one-time backup codes — download or print these and store them somewhere safe. Use a backup code to regain access if you ever lose access to your authenticator app.
Enforce 2FA across your entire workspace by going to Settings → Security and enabling Require 2FA for all members. Members who haven’t set up 2FA will be prompted to do so the next time they log in.