> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hany.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# Hany Account: Manage Profile, API Keys and Security

> Learn how to manage your Hany account: update profile details, manage API keys, set notification preferences, and control team access.

Your Hany account is the control centre for everything — your credits, your API keys, your sender IDs, and your notification preferences. This page walks you through all the settings available to you and how to keep your account secure and up to date.

## Profile Settings

Keep your business details accurate so invoices, notifications, and account communications go to the right place.

To update your profile:

<Steps>
  <Step title="Log in to your Hany dashboard">
    Visit [hany.tools](https://hany.tools) and sign in with your credentials.
  </Step>

  <Step title="Navigate to Account Settings">
    Click your profile avatar or business name in the top-right corner, then select **Settings**.
  </Step>

  <Step title="Update your details">
    Edit any of the following fields and click **Save Changes**:

    * **Full name** — your personal name as account owner
    * **Email address** — used for login, notifications, and receipts
    * **Business name** — displayed on invoices and sender ID applications
    * **Phone number** — used for account verification and support contact
  </Step>
</Steps>

<Note>
  Keep your account email address up to date. Hany uses it to send important service notifications, low-credit alerts, and announcements about new features.
</Note>

## API Keys

Your API key authenticates all requests you make to the Hany API. Treat it like a password — guard it carefully.

### Generate a New API Key

<Steps>
  <Step title="Go to Settings → API Keys">
    From your dashboard, navigate to **Settings**, then select the **API Keys** tab.
  </Step>

  <Step title="Click 'Generate New Key'">
    Give your key a descriptive label (for example, `production-app` or `crm-integration`) so you can identify it later.
  </Step>

  <Step title="Copy and store the key immediately">
    Your full API key is only shown once at the time of generation. Copy it and store it securely in your environment variables or secrets manager before closing the dialog.
  </Step>
</Steps>

### Revoke an API Key

If a key is compromised or no longer needed, revoke it immediately:

<Steps>
  <Step title="Go to Settings → API Keys">
    Find the key you want to remove in the list.
  </Step>

  <Step title="Click 'Revoke'">
    Confirm the action. The key is invalidated instantly — any requests using it will receive a `401 Unauthorized` error.
  </Step>

  <Step title="Issue a replacement key if needed">
    Generate a new key and update your integration with the new value.
  </Step>
</Steps>

### Best Practices

* **One key per integration** — use a separate API key for each application or service that connects to Hany. This way, if one key is compromised, you can revoke only that key without disrupting other integrations.
* **Rotate keys regularly** — generate a new key and retire the old one every few months as part of your security hygiene.
* **Use environment variables** — never hardcode your API key in source code. Store it as an environment variable or in a secrets manager like AWS Secrets Manager, HashiCorp Vault, or your CI/CD platform's secret store.

<Warning>
  **Never share your API key publicly.** Do not commit it to version control, paste it in a support chat, or expose it in client-side JavaScript. Anyone with your key can send messages and consume your credits.
</Warning>

## Notification Preferences

Stay informed about the events that matter to your business. You can configure which notifications Hany sends you under **Settings → Notifications**.

Available notification types:

| Notification               | Description                                                                          |
| -------------------------- | ------------------------------------------------------------------------------------ |
| **Low credit balance**     | Get an alert when your SMS credits drop below a threshold you set                    |
| **Delivery failures**      | Be notified when a message fails to deliver so you can investigate or retry          |
| **New services launching** | Receive announcements when IVR, USSD, Email Marketing, and Payments become available |

## Security

### Change Your Password

<Steps>
  <Step title="Go to Settings → Security">
    Select the **Security** tab within your account settings.
  </Step>

  <Step title="Enter your current password">
    Confirm your identity before making changes.
  </Step>

  <Step title="Set and confirm your new password">
    Choose a strong password of at least 12 characters, mixing letters, numbers, and symbols. Click **Update Password**.
  </Step>
</Steps>

### Two-Factor Authentication (2FA)

Where available, enable two-factor authentication to add a second layer of protection to your account. With 2FA enabled, logging in requires both your password and a one-time code from your authenticator app. Check **Settings → Security** to see if 2FA is enabled for your account tier.

## Deleting Your Account

If you need to permanently close your Hany account, contact our support team directly:

[support@hany.tools](mailto:support@hany.tools)

Include your registered email address and the reason for deletion. Our team will confirm your identity, process the request, and send you a confirmation. Note that account deletion is irreversible — any remaining credit balance will be forfeited.