Skip to main content
All HoopAI API requests authenticate with a Private Integration key — a scoped API token tied to your account.

​
Required headers

Every request needs two headers:
HeaderValueRequired
AuthorizationBearer YOUR_API_KEYAlways
Version2021-07-28Always
Content-Typeapplication/jsonPOST / PUT / PATCH only
curl https://services.leadconnectorhq.com/contacts/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Version: 2021-07-28"

​
Get your API key

You generate your API key in Settings > Integrations > Private Integrations in your HoopAI dashboard.

Step-by-step: Create an API key

Create a Private Integration key in under 2 minutes

​
Get your Location ID

Your Location ID scopes requests to your account. Find it at Settings > Business Profile — it’s displayed at the top of the page.

Find your Location ID

Where to find your Location ID

​
Security best practices

  • Never commit your API key to version control — use environment variables
  • Create separate keys for development and production
  • Rotate keys immediately if you suspect exposure
  • Select only the scopes your integration needs

​
Verifying webhook signatures

When HoopAI sends webhooks to your server, always verify the request came from HoopAI before processing it. See Webhook Signatures for details.

​
Next steps

First request

Make your first API call

Making requests

Pagination, filtering, error handling
Last modified on March 7, 2026