<!-- BusyBot node reference — https://busybot.net/tools/invoice-ninja-trigger/ -->

> Node: Invoice Ninja Trigger (`invoice_ninja_trigger`) · Webhook trigger · v1
> Category: Finance · Credentials: Invoice Ninja API (`invoiceNinjaApi`)
> Updated: 2026-08-16

# Invoice Ninja Trigger

> Trigger workflow from Invoice Ninja webhook events

## Overview

Starts a workflow when Invoice Ninja sends a webhook event. Supports events for client creation, invoice creation, quote creation, payment creation, and vendor creation. The trigger registers a webhook subscription via the Invoice Ninja API (v4 or v5) so that when the selected event occurs in Invoice Ninja, the platform receives a POST with the full entity payload. Supports both self-hosted and cloud-hosted Invoice Ninja instances.

**Category:** Finance  
**Tool Name:** `invoice_ninja_trigger`  
**Version:** 1

**Appearance:** Icon: `lucide-Receipt` | Color: `#252c2e`

## Node Type

**Trigger** — webhook (receives incoming HTTP callbacks)

## Input / Output

| Direction | Port(s) |
|-----------|--------|
| Input | None (trigger node) |
| Output | `Output` |

## Credentials

This tool requires **Invoice Ninja API** credentials.
See the [Credentials Guide](https://busybot.net/credentials/invoice-ninja-api/) for setup instructions.

### Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| API Version | `options` | No | `v5` | The API version of your Invoice Ninja instance. Use v4 for older installations and v5 for newer ones. |
| | | | | Options: `v4` (Version 4), `v5` (Version 5) |
| Event | `options` | Yes | — | The Invoice Ninja event that triggers the workflow. |
| | | | | Options: `create_client` (Client Created), `create_invoice` (Invoice Created), `create_payment` (Payment Created), `create_quote` (Quote Created), `create_vendor` (Vendor Created) |

One node listens for one event. To react to several events, add one Invoice Ninja Trigger node per event.

## Output Data

Each delivery produces one output item. Invoice Ninja posts the full entity as the request body, and those fields are placed directly on the item alongside three metadata fields:

```json
{
  "id": "invoice_test_000001",
  "number": "INV-0001",
  "client_id": "client_test_000001",
  "status_id": "2",
  "amount": 150,
  "balance": 150,
  "date": "2026-01-01",
  "due_date": "2026-01-31",
  "line_items": [],
  "created_at": 1767225600,
  "updated_at": 1767225600,
  "_trigger": "invoice_ninja_webhook",
  "_timestamp": "2026-01-01T00:00:00.000Z",
  "_webhookEvent": "create_invoice"
}
```

- `_trigger` — always `invoice_ninja_webhook`.
- `_timestamp` — ISO 8601 timestamp of when the delivery arrived.
- `_webhookEvent` — the event this node subscribed to. Invoice Ninja sends no event type in the payload, so this value comes from the node's own Event setting.

The remaining fields are the entity Invoice Ninja sent:

| Event | Entity on the item |
|-------|--------------------|
| `create_client` | Client record — `id`, `name`, `display_name`, `balance`, `paid_to_date`, `credit_balance`, `contacts[]`, address fields, `created_at`, `updated_at` |
| `create_invoice` | Invoice record — `id`, `number`, `client_id`, `status_id`, `amount`, `balance`, `discount`, `po_number`, `date`, `due_date`, `line_items[]`, `public_notes`, `private_notes` |
| `create_payment` | Payment record — `id`, `client_id`, `amount`, `refunded`, `applied`, `date`, `transaction_reference`, `type_id`, `invoices[]` |
| `create_quote` | Quote record — `id`, `number`, `client_id`, `status_id`, `amount`, `discount`, `date`, `valid_until`, `line_items[]` |
| `create_vendor` | Vendor record — `id`, `name`, address fields, `phone`, `website`, `contacts[]` |

Reference values downstream by expression, for example `{{ $json.number }}` or `{{ $json.client_id }}`.

## Usage Examples

- trigger workflow when a new invoice is created in Invoice Ninja
- listen for new client creation events from Invoice Ninja
- start workflow when a payment is received in Invoice Ninja
- react to new quote creation in Invoice Ninja
- trigger on new vendor creation in Invoice Ninja

## Example Configuration

Fire when an invoice is created on a v5 instance:

```json
{
  "type": "invoice_ninja_trigger",
  "parameters": {
    "apiVersion": "v5",
    "event": "create_invoice"
  }
}
```

Fire when a payment is recorded:

```json
{
  "type": "invoice_ninja_trigger",
  "parameters": {
    "apiVersion": "v5",
    "event": "create_payment"
  }
}
```

Onboard new clients from a legacy v4 installation:

```json
{
  "type": "invoice_ninja_trigger",
  "parameters": {
    "apiVersion": "v4",
    "event": "create_client"
  }
}
```

Follow up on new quotes:

```json
{
  "type": "invoice_ninja_trigger",
  "parameters": {
    "apiVersion": "v5",
    "event": "create_quote"
  }
}
```

### Trigger Behavior

- **Activation:** When the workflow is activated, a webhook endpoint is registered with the service.
- **Deactivation:** The webhook is automatically unregistered when the workflow is deactivated.
- **Payload:** The incoming webhook payload is parsed and output as workflow items.
- **Verification:** Supports signature verification where applicable.

## Tips

Receives webhook events from Invoice Ninja. Select the API version (v4 or v5) matching your Invoice Ninja instance, then choose which event to listen for. The trigger registers a webhook subscription via the Invoice Ninja API. When the selected event occurs, Invoice Ninja sends a POST request with the full entity data.