clerra

Clerra for n8n — start workflows when a proposal is accepted, a letter is signed, a client sends their documents, a filing is filed or an invoice is paid; add clients, jobs, notes, to-dos and leads.

Documentation

n8n-nodes-clerra

Clerra is practice management for Canadian accounting firms: CRA and provincial deadlines, recurring work, the client portal, documents, time and invoicing. This package adds Clerra to n8n.

  • Clerra Trigger starts a workflow the moment something happens in Clerra.
  • Clerra adds clients, jobs, notes, to-dos and leads, and finds clients, jobs and leads.

They offer exactly what Clerra's Zapier app does, with the same field names and help.

Install

In n8n: Settings → Community nodes → Install, enter n8n-nodes-clerra, and confirm. (n8n Cloud lists only community nodes n8n has verified.)

Connect

  1. In Clerra: Settings → API. Switch API access on if it's off, then New key. Name it n8n and tick what n8n may do — to add clients, Add clients; for triggers, Read activity and Manage webhooks plus the kind of record (for example Read invoices for Invoice Paid). Copy the key; it's shown once.
  2. In n8n, add a Clerra node, then Credential → Create new credential → Clerra API, paste the key and save. n8n checks it with Clerra straight away.

The API works on paid Clerra plans (not during the free trial). Everything added through the key is recorded in Clerra as added by the person who made it. Revoke the key in Settings → API to stop every workflow using it at once.

Clerra OAuth2 API connects through Clerra's Allow screen instead of a key. Clerra registers each OAuth app with the exact redirect URL n8n shows, so ask Clerra for a Client ID and Secret before using it.

Clerra Trigger

Choose the Event, then activate the workflow. Activating subscribes the workflow's URL to that one event in Clerra; deactivating removes the subscription. Each delivery's Clerra-Signature is checked against the request's raw body before the workflow runs — anything unsigned, changed or more than five minutes old is refused. Clerra only sends to a public https address, so your n8n must be reachable at one.

Area Events
Clients New Client · Client Status Changed
Filings Filing Marked Filed · Filing Status Changed · Filing Became Overdue
Billing New Invoice · Invoice Sent · Invoice Paid · Payment Received · Invoice Became Overdue · Card Payment Failed
Work New Job · Job Status Changed
Sales pipeline New Lead · Lead Stage Changed
Documents Document Uploaded (optional Uploaded by) · Client Sent Everything Requested · Document Request Completed
Engagements Proposal Accepted · Document Signed (optional What was signed)
Inbox New Email at Intake Address

Document events carry a document's details (name, size, folder, who uploaded it) — never the file or a link to it. Intake events carry the sender and subject line, never the message.

Clerra

Resource Operations
Client Create (builds the client's filing deadlines the same way as Add client in Clerra; never guesses a type, year end or province; returns the client already there with the same email or business number) · Add Note · Find (by email, business number or name)
Job Create (from one of your job templates, or blank) · Find
Lead Create · Find
To-Do Create

The same job, note or to-do sent again within a day is returned, not added twice. Dropdowns for clients, job templates and team members are read from your firm's Clerra; you can also map an ID from an earlier step.

Help

Guide: Help → "n8n: Clerra in your workflows" in Clerra. API reference: https://clerra.ca/developers. Support: support@clerra.ca

Discussion