---
title: How to create an API key | HelpRange Help
url: https://www.helprange.com/help/create-an-api-key
---

# How to create an API key

A team administrator opens **API keys** in the left menu, gives the key a name, picks its scopes (or **Read-only** / **Full access**), chooses **Live** or **Test (sandbox)**, optionally an expiry date, and clicks **Create key**. Copy it right away – it is shown only once.

**Plan:** Pro and higher (Pro, Max, Unlimited), the Deal Room Pass and the 7-day trial. [See plans](https://www.helprange.com/pricing)

## Steps

1. As a team administrator, open **API keys** under **Settings** in the left menu.
2. Under **Create a key** enter a **Name** (e.g. CRM sync).
3. Tick the **Scopes** the integration needs, or use the **Read-only** or **Full access** preset.
4. Choose the **Mode**: **Live** for your real data or **Test (sandbox)** for sample data. Set **Expires (optional)** if you want.
5. Click **Create key** and copy it – “Copy it now – it is shown only once.”
6. Send it as `Authorization: Bearer hr_live_…` or `X-API-Key: hr_live_…`. Later use **Roll key** to replace it or **Revoke** to stop it at once.

Opens the right page in HelpRange. New to HelpRange? Sign up first – 7-day free trial, no card.
 [Create an API key](https://www.helprange.com/help/create-an-api-key/start)

## Who the key acts as

A key acts with the permissions of the administrator who created (or last rolled) it. If that person leaves the team, the key stops working – roll it. Older per-member keys (**Legacy key (full access, live)**) keep working; switch integrations to a scoped key when you can.

## Test keys

Test keys (`hr_test_…`) only see a separate sandbox with sample documents, links and a data room. The sandbox sends no e-mails and makes no payments; **Reset sandbox** starts it again.

## Limits and good to know

- Up to 50 keys per team.
- When rolling, the old key can keep working for 24 hours or 7 days, or stop at once.
- 3,600 API requests an hour per team (at most 120 a minute), 300 write requests an hour, 2,000 new share links a day.
- Sandbox data is deleted after 30 days.

## Learn more

- [API documentation](https://www.helprange.com/api-documentation)
- [API keys, scopes and the sandbox](https://www.helprange.com/developers/keys)

## Related tasks

- [How to connect Zapier, Make or n8n](https://www.helprange.com/help/connect-zapier-make-or-n8n)
- [How to connect Claude or ChatGPT with MCP](https://www.helprange.com/help/connect-claude-or-chatgpt-with-mcp)
- [How to connect your CRM](https://www.helprange.com/help/connect-your-crm)

Updated 16 November 2026 · Checked against the current product · [All help topics](https://www.helprange.com/help) · [FAQ](https://www.helprange.com/faq)
