HiloVoice
Start free
All topics
  1. Getting started
    1. Create your account
    2. Get started with the guided welcome
    3. Invite your team
    4. Keep your number and forward it to your agent
    5. Set up your first agent
    6. A tour of HiloVoice
    7. Get help
  2. Concepts
    1. What HiloVoice does
    2. The five kinds of agent
    3. Phone numbers and caller ID
    4. Campaigns and recipients
    5. Calls, leads and contacts
    6. Roles and permissions
  3. Building an agent
    1. How the builder works
    2. Describe the business
    3. Name the agent and give it a purpose
    4. Set your opening hours
    5. Handle each kind of caller
    6. Choose what the agent asks
    7. Give the agent answers
    8. Shape how a call sounds
    9. Give a Receptionist its number
    10. Write an outbound agent's opening
    11. Set a follow-up's goal
    12. Set when an outbound agent may call
    13. Give an outbound agent a caller ID
    14. Turn callers into leads
    15. Book appointments on a call
    16. Hand calls to a person
    17. Turn away callers you can't help
    18. Let the agent check your records
    19. Send messages after a call
    20. Review and go live
    21. Start a new agent from one you have
    22. Pause, archive or delete an agent
    23. Call new leads within seconds
  4. Agent playbooks
    1. Set up a receptionist for a clinic
    2. Confirm tomorrow's appointments
    3. Check the details you hold
    4. Ask for feedback after a visit
    5. Follow up on open quotes
  5. Testing and going live
    1. Test an agent with Try it
    2. Put a Receptionist on the web
    3. Check an agent before real calls reach it
    4. Your responsibilities on calls
  6. Campaigns
    1. How a campaign runs
    2. Create a campaign
    3. Import a campaign's recipients
    4. Set a campaign's calling hours and retries
    5. Monitor a running campaign
    6. Work the Needs a person queue
    7. Call a recipient again
    8. Read a follow-up's progress
  7. Day-to-day operations
    1. The Usage page
    2. Review your calls
    3. Follow up your leads
    4. Keep your contacts up to date
    5. Set up transfer destinations
    6. Put callers straight through to a person
    7. Block a number
    8. Keep up with notifications
  8. Integrations
    1. What you can connect
    2. Connect your own Twilio account
    3. Connect your calendar
    4. Send email from your own address
    5. Connect HubSpot
    6. Connect Salesforce
    7. Connect Slack
    8. Connect Zapier
    9. Send leads to your own system
    10. Add a lookup source
  9. Administration
    1. Change your organization's settings
    2. Manage members and roles
    3. Manage your phone numbers
    4. Plans, minutes and limits
    5. Make and revoke API keys
    6. Check who did what in the activity log
    7. Manage your own account
    8. Join the HiloVoice affiliate program
  10. Reference
    1. Glossary
    2. Campaign statuses
    3. Recipient statuses
    4. Follow-up dispositions
    5. Call statuses and outcomes
    6. Agent builder fields
    7. CSV columns
    8. Error messages
    9. Frequently asked questions

Make and revoke API keys

For OwnersChecked against the app on October 5, 2026

Settings → API keys lets your own programs use HiloVoice: read your calls, leads, appointments, contacts and campaigns, keep your contacts in step, and add people to campaigns. Each program presents a key. A key acts as the person who made it, with their rights.

Before you start

  • You're an Owner or Admin. Builders and Analysts don't see API keys in Settings; opened another way, the page says Only an owner or admin can see and make API keys.
  • Your plan includes The HiloVoice API. Where it doesn't, New key is greyed out, with a lock showing the plan that has it, such as Growth and up.
  • Settings is in the account menu at the foot of the sidebar.
  • An organization can have 20 keys at once.

The keys list

Each key shows the name you gave it, its first characters, such as hv_Ab12Cd3…, who made it and when, and when it was last used, or not used yet. The full key is never shown again after you make it. To tell which key a program has, compare its first characters.

Settings → API keys: two keys, each with its first characters, who made it and when, and when it was last used; New key at the top and an X beside each.

Read the API reference, under the page title, opens the reference for the HiloVoice API in a new tab: every request a program can make, and what it gets back.

Steps

Make a key

  1. Open Settings → API keys and click New key.

  2. Under What will use it?, type a name for the program, such as Our CRM sync.

    What will use it?, with Our CRM sync typed in, and Make key beside it.

  3. Click Make key. The Copy your key now dialog opens.

  4. Click the copy button beside the key. A message says Key copied.

    Copy your key now: the key with its copy button, the request to try it with, and I've copied it.

  5. Paste the key into your program, or somewhere safe, before you close the dialog.

  6. Click I've copied it.

The dialog also has a request to try the key with, under Try it: this asks which organization the key is for. Its copy button copies it whole.

Important: The key is shown this once. Keep it like a password: anyone with it can do what you can through the API. If you lose it, revoke it and make a new one.

Tip: Make one key for each program. Then you can revoke one without stopping the rest.

Revoke a key

  1. On API keys, click the X beside the key.
  2. Read Revoke "<name>"?, then click Revoke. A message says Revoked "<name>". Programs using it stop working now.

Important: A revoked key can't be brought back. Programs using it stop working at once; make a new key to replace it.

What happens next

  • A key works from the moment it's made. Its row shows when it was last used.
  • A key stops working, on the program's next request, when:
    • it's revoked;
    • the person who made it leaves the team, is removed, or is no longer an Owner or Admin;
    • your plan stops including The HiloVoice API. It works again when the plan includes it.
  • Making and revoking keys is recorded under Settings → Activity, in API keys. Not every plan includes the activity log.

If it does not work

You seeWhyWhat to do
There's no API keys in SettingsYour role is Builder or AnalystAsk an owner or admin to make the key, or to change your role.
New key is greyed out, with a lock such as Growth and upYour plan doesn't include the APIAn owner can change the plan under Settings → Billing.
An organization can have 20 keys at once. Revoke one you no longer use first.There are 20 keys alreadyRevoke one you no longer use.
Couldn't make the key.Making the key failedTry again.
Your program is told This API key doesn't work: it may have been revoked. An owner or admin can make a new one under Settings → API keys.The key was revoked, or was copied wronglyMake a new key, and copy it whole.
Your program is told The person who made this API key is no longer an owner or admin here, so it no longer works. An owner or admin can make a new one under Settings → API keys.Its maker left, was removed or has another roleMake a new key yourself.
Your program is told That isn't a HiloVoice API key. Send one as "Authorization: Bearer hv_…"; an owner or admin makes keys under Settings → API keys.The program isn't sending the key the right wayCheck the request against Read the API reference.
Your program is told The HiloVoice API is on <plan> and up. An owner can change the plan under Settings → Billing.The plan no longer includes the APIAn owner can change the plan. The key works again once it does.