An API key lets your own software call Harkbell's API on behalf of one business. Only Owners and Admins can create one.
- Open Settings and choose the Developers tab.
- Under API keys, type a Key name that says what will use it, such as Zapier.
- Press Create key.
- Press Copy key and store it somewhere safe. Harkbell shows it once and keeps only a fingerprint.
- Press Done.
Send the key as Authorization: Bearer followed by the key on every request. Keys start with hk_live_. The developer reference lists every endpoint and example.
Keep the key on a server
The API refuses requests from web pages, so never put a key in a website or an app where visitors can read it. A business can hold up to 10 active keys; revoke one you no longer use before creating another.
Revoke a key
Press Revoke beside the key and confirm Revoke key. Everything using it stops at once, and its automations are switched off. A key is also revoked automatically when the person who created it leaves the team or stops being an Owner or Admin.
I lost the key. Can I see it again?
No. Create a new key, update whatever used the old one, and revoke the old key.
What can a key do?
It lets your software read events and add or update contacts and callbacks for that business. The developer reference lists exactly what it can reach.