Generate and use API keys and webhooks
Create API keys to access Omnifox programmatically and set up webhooks to receive real-time events.
Watch this step in the video · Create an API key
If you want to connect Omnifox with your own systems or automate actions, the REST API and webhooks are your best allies. API keys authenticate your API calls; webhooks notify you the instant something happens in your workspace. Here you'll learn how to generate and use both.
Generate an API key
- Open API Keys in the side menu.
- Press New API key.
- Give it a descriptive name (for example, "Online store integration").
- Select the permissions (scopes) it needs: contacts, conversations, messages, etc.
- Press Generate. Copy the key right away: for security it is shown only once.
Store the key somewhere safe (a secrets manager). If you lose it, revoke it and create a new one.
Use your API key
Include the key in the Authorization header of every request:
Authorization: Bearer YOUR_API_KEY- The REST API V1 lives at
/api/v1/*(for example,https://omnifox.io/api/v1/contacts). - Respect the rate limits; if you receive a
429, wait and retry.
Set up a webhook
- Open Webhooks in the side menu.
- Press New webhook.
- Paste the destination URL (a public endpoint on your server that accepts POST).
- Check the events you want to receive: incoming message, conversation created, contact updated, etc.
- Save. Omnifox will send a POST with a JSON body each time the event occurs.
Verify and secure your webhooks
- Every delivery includes a signature in the headers; validate it with your webhook secret to confirm the event is legitimate.
- Respond with a
200quickly. If your endpoint fails or is slow, Omnifox will retry with backoff. - Always use HTTPS.
Best practices
- Create one API key per integration, so you can revoke one without affecting the others.
- Grant only the minimum permissions needed.
- Log every webhook received to make debugging easier.
Tip: test your webhooks with a tool like a request-inspection endpoint before pointing them at production. You'll see the exact JSON format and avoid surprises.
Related articles
-
How to connect integrations and external apps
Connect Omnifox with your favorite tools from the integrations catalog in just a few steps.
-
Integrations and API complete guide
Integrations and API in depth, in 30 chapters: API keys, real calls, signed webhooks, n8n, MCP and SDKs, all really working.
-
Connecting Omnifox to Azur, Siigo, Alegra, QuickBooks or another accounting system or ERP
Omnifox doesn't have a native connector for accounting systems or ERPs today. Here's how to connect them anyway with workflows, the HTTP node, n8n, Make, Zapier or the API, with examples.
-
Getting started with integrations (webhook / OAuth / API key)
Connect Omnifox with your other tools: what's available today, what's coming soon, and when to use a webhook, an OAuth connection or an API key.
-
The Omnifox REST API: introduction and plan requirements
What the Omnifox REST API is, which plan you need (Crece and up), how to authenticate with the X-API-Key header, and where the docs live.