Overview
API Keys manages the one active production key that authenticates requests to the public SalesHive Platform API for the selected client. Copy the base URL or API key into an integration, review usage, rename the active key, replace it when a new copyable value is needed, and revoke it when it should stop working. Full key values are shown only once, while revoked keys remain in the history for audit reference.
How to use this page
Check the client and API status
Confirm the selected client in the Client Switcher. The status band shows whether an active key is ready, when it was last used, the total request count, and how many revoked keys are retained. Copy the Base URL, https://app.saleshive.com/api/public/v1, when your integration asks for the public API endpoint.
Create the first key
If there is no active key, enter a name such as Production API Key and click Create API key. SalesHive displays the full value only once. Copy it immediately, paste it into the integration's API Key field, and store it in a secret manager. Keep the page open until the integration accepts it.
Review or rename the active key
The Active Key card shows the key name, a masked value, and Created, Last used, and Requests statistics. The masked value is not usable as the secret. Click Rename, edit the name, then choose Save or Cancel; renaming does not change the key value.
Get a new copyable key
Click Get a copyable key when the current full value was not saved or you need a fresh value. Confirm with Replace key. The current key is revoked immediately, a new active key is issued, and the full replacement appears once with a Copy API key button. Copy it into the integration right away, and do not paste the Base URL into the API Key field.
Revoke a key and review history
Click Revoke key and confirm when the active key should stop authenticating without a replacement. Rotated and revoked keys appear in Key History with their masked values and timestamps, but they cannot be used again.
What the buttons do
- View API docs
- Opens the public SalesHive Platform API documentation in a new tab.
- Copy (base URL)
- Copies https://app.saleshive.com/api/public/v1 for the integration's API endpoint.
- Create API key
- Creates the client's one active key when no active key exists. The full value is displayed only once.
- Copy API key
- Copies the full newly created or replacement key while it is displayed. The key cannot be revealed again after leaving or refreshing the page.
- Get a copyable key
- Opens a confirmation to revoke the current key and issue a new one whose full value can be copied once.
- Replace key
- Confirms the replacement from the dialog. The old key stops working immediately.
- Rename
- Opens the active key name for editing without changing the key value.
- Save
- Saves the edited active key name.
- Cancel
- Closes the active key name editor without saving the edit or closes the replacement confirmation without replacing the key.
- Revoke key
- Asks for confirmation, then disables the active key without issuing a replacement.