Integration · Automations

Automations, API keys & webhooks

Everything for automating InfiniReach lives under Automations, with three tabs: Workflows, API Keys, and Webhooks.
10 minutes Admins and developers Last updated October 12, 2026

Moved from Integrations

API keys and webhooks used to be under Integrations. They’re now in Automations. Integrations is for GoHighLevel.
Automations page with the Workflows, API Keys and Webhooks tabs
Automations page with the Workflows, API Keys and Webhooks tabs
1

Create a workflow

  1. Click Automations in the sidebar and stay on the Workflows tab.
  2. Click + New Automation.
  3. Enter a name, choose the Trigger Event, and click Create.
  4. Click the workflow’s name to open the Builder.

The Builder has four parts:

SectionWhat it does
TriggerWhat starts the workflow.
ConditionsOptional checks that decide whether to continue.
Action StepsWhat to do: Send SMS, HTTP Request, or Delay / Schedule.
Run HistoryEach run’s payload, condition result, step output, errors, and duration.

Click ▶ Test to try the workflow with a sample payload. Copy variables like {{trigger.field}} into your steps.

Workflow Builder with Trigger, Conditions, Action Steps and Run History
Workflow Builder with Trigger, Conditions, Action Steps and Run History
In Send SMS you can use [[Hi|Hello]] spintax. See Spintax.

Available triggers

TriggerEvent
SMS Receivedmessage.inbound
SMS Deliveredmessage.delivered
SMS Failedmessage.failed
WhatsApp Receivedwhatsapp.message.inbound
WhatsApp Disconnectedwhatsapp.disconnected
Missed Callcall.missed
Device Offlinedevice.offline
Inbound Webhookwebhook.inbound
2

Create an API key

  1. Go to Automations → API Keys.
  2. Click + Create API Key.
  3. Name it after the tool that uses it, for example n8n production.
  4. Copy the key right away. It’s shown only once.

Send it in the X-API-Key header:

curl -X POST https://api.infinireach.io/api/v1/messages \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "channel": "sms",
    "from": "+15559876543",
    "to": "+61400000000",
    "message": "Hello from InfiniReach"
  }'

from must be one of your connected numbers. Full details in the API reference.

Creating an API key and copying it
Creating an API key and copying it
3

Create an outbound webhook

InfiniReach sends a POST to your URL when an event happens.

  1. Go to Automations → Webhooks and click + Create Webhook.
  2. Enter a Name and your HTTPS Webhook URL.
  3. Under What should this webhook listen to?, choose SMS, WhatsApp, or Device offline.
  4. Tick the Events you want. Optionally limit it to certain numbers, SIMs, or WhatsApp instances.
  5. Optional: add a Secret. Each request is then signed in the X-Webhook-Signature header (HMAC-SHA256 of the raw body).
  6. Make sure Active is ticked and save. Use Test to send a sample.
Create webhook window with URL, type, events and secret
Create webhook window with URL, type, events and secret
A webhook is turned off automatically after 50 failed deliveries. Fix the URL, tick Active again, and save.
4

Start a workflow from another tool (Inbound Webhook)

  1. Create or open a workflow.
  2. Set the trigger to Inbound Webhook and save. InfiniReach creates a receiver URL ending in /hook/{webhookSlug}.
  3. Copy the URL into your other tool.
  4. Choose authentication: No Auth, Header Secret, or Basic Auth.
  5. Click Start Listening and send a test request to capture a sample payload.
  6. Use the top-level JSON keys in conditions, and {{trigger.keyName}} in steps.

Example: for a body {"orderId":"123","status":"paid"}, check status in a condition and use {{trigger.orderId}} in a step.

Best practices

  • Use a separate API key per tool, so you can revoke one without breaking the others.
  • Rotate keys and secrets after demos or screen recordings.
  • Return HTTP 200 quickly from your webhook endpoint and do heavy work afterwards.
  • Use Header Secret or Basic Auth in production, not No Auth.
  • Debug with Run History.

Related guides