@singlefax/n8n-nodes-singlefax
v0.1.4
Published
Send a fax from n8n with SingleFax. Charged only when delivery succeeds. Not for protected health information.
Maintainers
Readme
SingleFax for n8n
Send a fax from an n8n workflow. Quote, status, credits, and the received-fax inbox use the same API key. You are charged only when delivery succeeds.
This is not Secure Mode. Do not send protected health information. HIPAA stays on the SingleFax website.
Nodes
| Node | What it does |
| --- | --- |
| SingleFax | Send Fax, Get Fax Status, Quote Fax, Get Credits, List Received Faxes |
| SingleFax Received Fax | Polls the inbox. The first run records faxes already there and does not emit them. |
| SingleFax Fax Delivered | Webhook for fax.delivered and fax.failed. Verifies SingleFax-Signature. |
Send Fax takes the binary file from the previous node, or a public https URL. It uploads the original file, then creates the fax. Do not convert the file to PDF first.
Credential
Create an API key at https://singlefax.com/dashboard.
| Operation | Scope |
| --- | --- |
| Send Fax | fax:send |
| Get Fax Status, Quote Fax | fax:read |
| List Received Faxes, On Received Fax | inbox:read |
| Get Credits | credits:read |
The key stays in the n8n credential. This package does not contain one.
Delivery trigger
- Activate the workflow so n8n shows the production webhook URL.
- Add that URL at https://singlefax.com/dashboard/webhooks.
- Enable
fax.deliveredandfax.failed. - Paste the signing secret (
whsec_…, shown once) into the credential field Webhook Signing Secret.
The node checks the HMAC over the raw request body. Other event types are acknowledged and do not start the workflow.
Install
- Self-hosted n8n: Settings → Community nodes → install
@singlefax/n8n-nodes-singlefax. - n8n Cloud: the node appears in the nodes panel after n8n verifies it.
Example workflow: workflows/send-fax.json. Replace the destination number and attach your own file.
Release
Merging to main runs tests, bumps the patch version if npm is behind, commits chore(n8n): x.y.z [skip ci], and publishes with GitHub Actions provenance. Push a vX.Y.Z tag to publish that exact version without a patch bump. Manual publish: Actions → Publish → Run workflow with publish checked.
