Skip to main content
Private Integrations allow you to build custom connections between the HoopAI Platform and external systems using API keys, webhooks, and OAuth applications. Use this section when a pre-built integration is not available or you need more control over how data flows between platforms.

​
Accessing private integrations

Go to Settings in the left sidebar, then select Private Integrations.

​
API keys

Generate API keys to authenticate programmatic access to the HoopAI Platform API. API keys allow external tools, scripts, and services to read and write data in your account.

​
Creating an API key

1

Open private integrations

Go to Settings → Private Integrations.
2

Click create API key

Click Create API Key and give it a descriptive name (e.g. “Zapier Integration” or “Custom Webhook Script”).
3

Copy the key

Copy the generated key immediately — it will only be shown once. Store it securely.
4

Use in external systems

Pass the API key as a Bearer token in the Authorization header of API requests.
API keys grant access to your account data. Do not share them publicly or commit them to version control. If a key is compromised, delete it immediately and generate a new one.

​
Webhooks

Webhooks let external systems receive real-time event notifications from your HoopAI account. When a trigger event occurs (such as a new contact being created or a form being submitted), the platform sends a POST request with event data to your specified URL.

​
Setting up a webhook

  1. Go to Settings → Private Integrations → Webhooks
  2. Click Add Webhook
  3. Enter the destination URL where the platform should send event data
  4. Select the events to listen for (e.g. contact created, opportunity updated, form submitted)
  5. Click Save

​
Testing webhooks

Use the Send Test button to fire a sample payload to your webhook URL and verify it is receiving data correctly.

​
OAuth apps

If you are building a custom application that other users will connect to their Hoop accounts, you can register an OAuth app to use the standard OAuth 2.0 authorization flow. OAuth apps are appropriate for:
  • Software integrations built for clients
  • Internal tools that need delegated access to multiple accounts
  • Marketplace or white-label applications
Contact Hoop support for access to the OAuth app registration process.
Last modified on March 4, 2026