Account settings

Overview

Your account settings let you manage your profile, change your email, set display preferences, and create API keys for programmatic access. These settings let you personalize your experience and control how external tools and integrations access your account.

Find these settings under Settings in the main navigation.

Creating an account

After you submit the registration form, Akordo emails a verification link that expires in 12 hours. Open the link and choose the account's final password. Account creation only happens after this confirmation, so someone who knows your email address cannot choose your password for you.

If you started registration during an OAuth sign-in, the same browser can continue automatically after confirmation. A different browser completes the account safely but does not sign the original browser in; sign in there with the password you chose. Ignore an unexpected registration email.

Profile

Display name

Your display name appears anywhere your account is shown — in groups, when sharing songs, and in activity feeds. It doesn't have to match your email address.

To change it:

1. Go to Settings → Account & Security
2. Enter your display name in the field
3. Click "Save display name"

Display names are optional. If you don't set one, your email address will be used instead.

Email address

Changing your email

Email changes require verification for security. Here's how it works:

1. Go to Settings → Account & Security
2. Enter your new email address
3. Enter your current password to confirm it's really you
4. Click "Send verification email"

You'll receive a verification email at the new address. Open the link, review the new address, then press Confirm email change. Merely opening the link does not change the account, which keeps mail scanners and link previews from acting for you.

Until you verify:

• Your current email stays active
• The pending change shows in your settings with an expiration date
• You can cancel the request if you change your mind

Canceling a pending change

If you started an email change but changed your mind:

1. Go to Settings → Account & Security
2. Find the "Verification pending" section
3. Click "Cancel request"

The pending change is removed and your current email remains unchanged.

What happens after verification

Once you submit the confirmation page:

• Your email is updated immediately
• You'll need to log in with the new email address
• Any future password resets go to the new email

Password

Password management is available from both the login flow and account settings:

• Forgot password: Use the "Forgot password?" link on the login page to reset via email
• Change password: In Settings, enter your current password and choose a new one

A password reset signs out every browser and revokes existing OAuth tokens and API keys. A password change in Settings keeps the browser performing the change signed in, but signs out other browsers and revokes existing OAuth tokens and API keys. Reconnect integrations after either operation.

Preferences

Song display defaults

Set your preferred default for how chords are displayed in songs:

• Use letters (default): Chords show as C, D, E, F, G, A, B
• Use numbers: Chords show as 1, 2, 3, 4, 5, 6, 7 relative to the key

This sets your default for new songs you open. You can still toggle between letters and numbers on any individual song.

To change your default:

1. Go to Settings → Preferences
2. Toggle "Default to numbers for new songs"
3. Click "Save preferences"

Number notation is especially useful if you:

• Play in multiple keys and want to think in scale degrees
• Transpose frequently
• Use the Nashville Number System

API Keys

API keys let other applications connect to your Akordo account programmatically. This is useful for:

• Connecting AI assistants like Claude or ChatGPT
• Building custom integrations
• Automating tasks with scripts

Availability

API key access depends on your license. Check the "API Keys" section in Settings to see if it's enabled for your account.

Creating an API key

1. Go to Settings → API Keys
2. Enter a name for the key (e.g., "Claude Code", "My script")
3. Click "Create key"

Important: The key is shown once when created. Copy it immediately — you won't be able to see it again.

Managing existing keys

For your security, Akordo requires a browser session created within the last 15 minutes before it lists, creates, or deletes API keys. If the session is older, sign out and sign back in, then return to Settings.

Your API keys list shows:

• Name: What you called the key
• Prefix: The first few characters (to identify it)
• Access: Whether the key can call API v1, MCP tools, or both
• Created: When you made it
• Last used: When it was last used
• Expires: Keys expire after at most 90 days

Revoking a key

If a key is compromised or no longer needed:

1. Find the key in your list
2. Click Revoke
3. Confirm the revocation

Any applications using that key will lose access immediately.

For a walkthrough of connecting AI tools like Claude or ChatGPT, see AI assistants.

Security tips

• Name keys by purpose: "Home laptop" is more useful than "Key 1"
• Revoke unused keys: Reduce your attack surface
• Rotate periodically: Create a new key, update your apps, revoke the old one
• Never share keys: Keys are like passwords — treat them that way

Usage and limits

The Settings page shows your current usage:

• Songs: How many songs you have vs. your limit
• Setlists: How many setlists vs. your limit
• Groups: How many groups you're in vs. your limit
• Arrangements per song: Maximum arrangements per song
• Tunings per arrangement: Maximum tunings per arrangement

Limits depend on your license. If you're hitting limits, check if an upgrade is available.

Delete your account

Account deletion is permanent. Before starting, transfer or delete every group you own; Akordo blocks deletion while you remain an owner so a group can never be left without one.

1. Go to Settings → Account & Security → Delete account
2. Enter your current password
3. Type DELETE MY ACCOUNT exactly
4. Click Permanently delete account

Akordo rechecks both your password and the same live browser session before committing. An OAuth token or API key cannot authorize account deletion.

Your personal-only songs, setlists, imports, uploads, preferences, credentials, and profile are deleted. Content that also belongs to another user or group remains with those collaborators, but your ownership, membership, and identifying attribution are removed. Security records that must be retained are anonymized and expire under their documented retention schedule. Object-storage deletions are durably queued and retried if storage is temporarily unavailable.

Bulk data export is not yet available as a self-service feature. For an export request, email [email protected] from your registered email address.

Next steps

• AI assistants — connect Claude or ChatGPT using API keys
• API v1 — OAuth/API key auth, endpoint list, and OpenAPI
• Groups — collaborate with your band
• Songs — manage your charts