Integrations / n8n

n8n logo

Automation · HTTP Request + Webhook nodes

n8n + Sendjade

Self-hostable workflows: send messages and handle events with two nodes.

Works with the live API

What you can automate

  • Send a PDF from a cloud storage folder to a customer
  • Run an AI reply workflow on incoming messages
  • Create instances for new customers of your SaaS

Before you start

  • A Sendjade account with a connected instance (status Authorized). See Getting started.
  • Your **idInstance** (shown on the instance page in the console) and **apiTokenInstance** (shown once when you created the instance; press Generate new token if you lost it). Use a spare number while testing.
  • An n8n instance (cloud or self-hosted).

Set it up

  1. Add an HTTP Request node

    Method POST, the Sendjade URL, authentication None, and a JSON body. You can paste this node into the canvas (replace the two placeholders in the URL).

    Paste into n8n (Ctrl+V on the canvas)
    {
      "nodes": [
        {
          "name": "Send WhatsApp",
          "type": "n8n-nodes-base.httpRequest",
          "typeVersion": 4.2,
          "position": [0, 0],
          "parameters": {
            "method": "POST",
            "url": "https://api.sendjade.com/waInstanceYOUR_ID_INSTANCE/sendMessage/YOUR_API_TOKEN_INSTANCE",
            "sendBody": true,
            "specifyBody": "json",
            "jsonBody": "={{ JSON.stringify({ chatId: $json.phone, message: $json.message }) }}"
          }
        }
      ],
      "connections": {}
    }
  2. Keep the token out of the workflow JSON

    Store the idInstance and token as n8n credentials or environment variables and build the URL from them with an expression, so exported workflows do not contain the token.

  3. Receive events

    Register your endpoint under Webhooks (Admin role) or with POST /api/v1/webhooks. Choose the native format (default) and the events you need, such as message.received, message.delivered or message.failed. The signing secret is shown once. Add a Webhook node, copy its Production URL into Sendjade, and branch on {{$json.body.event}}.

Test it

Click **Execute node** with a sample item whose phone is your own number.

Troubleshooting

The pasted JSON does not appear

n8n node parameters differ slightly between versions. Add the node manually and copy the URL and JSON body from this guide.

I get 401 unauthorized

The idInstance or token in the URL is wrong. Copy both again from the console. Generating a new token makes the old one stop working immediately.

I get 409 instance_not_connected

The instance is not Authorized yet. Open it in the console, press Connect and scan the QR code.

I get 400 invalid_chat_id

Use international format with digits only, e.g. 2348012345678 (or 2348012345678@c.us). Remove spaces, dashes and the leading zero of the local number.

I get 422 recipient_opted_out

That person replied STOP (or was added to the opt-out list). Sendjade refuses to message them. Remove the number from Opt-outs only if they asked to hear from you again.

I get 429 daily_limit_reached or rate_limited

The number reached its 24-hour sending cap (default 500) or you are calling too fast. The cap protects your number from restriction. Slow down, and raise the cap only if your volume is genuine.

Ask AI to help me integrate n8n

Copy this prompt into ChatGPT, Claude or any assistant. It already knows Sendjade’s API, so the answer matches our endpoints.

The prompt is plain text that you copy yourself. Never paste real keys into an assistant; use placeholders.