Orbit

How to get your n8n webhook URL

In BYON mode, Orbit sends every message to an n8n webhook URL of yours. Here's how to get that URL.

If you already built the workflow in n8n

Open the workflow that will receive messages from Orbit and click the Webhook node (the first node, which receives the data). In the node panel, copy the Production URL — that's the one that goes into Orbit.

[PRINT: Webhook node open, with the Production URL highlighted]

If you still need to build the workflow

In your n8n, create a new workflow, click + to add a node and search for Webhook. In the node settings, set the HTTP method to POST.

[PRINT: searching for the Webhook node in the n8n palette]

[PRINT: node configuration with the POST method selected]

Each workflow needs a different Path

The Webhook node has a Path field (e.g. webhook/ig). This path is part of the URL and must be unique for each workflow. If you have one flow for Instagram and another for WhatsApp, each needs a different path — for example, webhook/ig for one and webhook/whats for the other. If two workflows share the same path, n8n doesn't know which one to send to and throws an error. Simple rule: one path, one workflow.

Copy the PRODUCTION URL (not the test one)

The Webhook node shows two tabs: Test URL and Production URL. Always use the Production URL. The Test URL only works for a few seconds, while the "Listen for test event" button is active — if you paste the test one into Orbit, the webhook stops working afterward.

[PRINT: the two tabs, Test URL and Production URL, with Production selected]

Activate the workflow

The Production URL only starts responding when the workflow is Active (toggle in the top-right corner turned on). Activate it before testing.

[PRINT: Active toggle switched on at the top of the workflow]

About the address: HTTPS with a domain, never an IP

Here's a detail that trips many people up. Depending on how your n8n is set up, the URL it shows may come with an IP address and http://, like this: http://12.34.56.78:5678/webhook/ig. That URL won't work in Orbit. Webhooks need HTTPS (a secure address). You must replace the IP part with your n8n domain, keeping the rest the same: https://your-n8n.com/webhook/ig. In other words: swap http://12.34.56.78:5678 for your domain https://your-n8n.com, and keep the /webhook/... at the end intact.

What if I don't have a domain?

It depends on where your n8n runs:

  • n8n Cloud (the official hosted n8n, n8n.io): the URL already comes with HTTPS and a domain — just copy it, nothing to replace.
  • Self-hosted n8n (your own server): you need a domain with an SSL certificate pointing to your n8n. Without it, the URL only has an IP and won't work as a secure webhook. If that's your case and you don't have a domain set up, talk to whoever manages your server — it's a one-time setup.

Paste it into Orbit

With the Production URL (HTTPS, with a domain) copied, go back to Settings → Channels → Configure → Advanced — my n8n and paste it into the Your n8n webhook URL field. Save.

Once connected, see the format of what Orbit sends in The JSON Orbit sends to your webhook and how to send the reply back in How to reply via API.

Didn't resolve it? support.orbit@expertbr.com

Back to Help