BusyBot

Reference · Credentials

Invoice Ninja API credentials

Used by 2 BusyBot nodes.

Type invoiceNinjaApi 3 fields

The Invoice Ninja credential holds an API token and, for self-hosted installations, the base URL of your instance. Version 5 installations can additionally require an API secret, which is why that optional field exists.

Fields

FieldTypeRequiredNotes
URL
url		 string No Base URL of your Invoice Ninja instance.
API Token
apiToken		 password Yes Your Invoice Ninja API token
Secret
secret		 password No Optional secret for v5

Getting your credentials

  1. Sign in to your Invoice Ninja instance as an administrator.
  2. Open Settings → Account Management → API Tokens (the exact path varies between v4 and v5).
  3. Create a token and copy it.
  4. If you self-host, set URL to your instance’s base URL. Leave it at the default for the hosted service.
  5. If your v5 installation is configured with an API secret, enter it in the Secret field; otherwise leave it empty.

Permissions and scopes

The token acts with the permissions of the user that created it, so generate it from an account whose access matches what the workflow needs.

Troubleshooting

  • 401 Unauthorized — the token is wrong, or a v5 instance requires the API secret that has not been supplied.
  • Connection refused or 404 — the URL is wrong for a self-hosted instance, or the instance is unreachable from the workflow environment.
  • Version mismatch behaviour — v4 and v5 differ; make sure the trigger’s API version selection matches your instance.

Frequently asked questions

When do I need the Secret field?

Only when a v5 installation is configured to require an API secret. Leave it empty otherwise — supplying a wrong value causes authentication to fail.

Do I need to set the URL?

For self-hosted instances, yes — it is how requests find your server. The hosted service uses the default.

Does one credential serve the node and the trigger?

Yes, both declare this type — but note the trigger also asks you to select the API version matching your instance.

Nodes that use Invoice Ninja API

One credential works across every node below — create it once and reuse it.

Last updated . Spotted something wrong? Tell us.