Connect n8n

You connect n8n with an API key from Settings. The key belongs to one workspace. It cannot read another workspace. n8n uses the same key as Zapier and Make.

Create your API key

1. 1

   Sign in.

2. 2

   Open Settings.

3. 3

   Under API keys, enter a name you will recognise, such as n8n.

4. 4

   Select Create API key. FreeAML shows the key once. Copy it into n8n. We store only a hash.

5. 5

   In n8n, add the FreeAML credential and paste the key. Leave the site as https://freeaml.com.au. Reports from actions you run go to the email on the account that created the key.

Trigger

n8n can start a workflow when something happens in your workspace. FreeAML sends the event to the hook n8n gives you. Pick one event on the FreeAML Trigger.

• Verification completed. The status is complete and the report is ready. You receive the verification id, reference, client email when we have one, person or entity, paid or unpaid, the completed time, a report link when there is one, and the workspace id.
• Verification failed, expired, or declined. FreeAML stores those as rejected, expired, and declined.
• Verification created. A new verification exists. invite_sent is true when the client email has gone out.

The payload does not include identity document images.

Actions

• Create verification. Enter the client email, an optional reference, an optional role, and who pays. Choose Your client pays or Your workspace pays. When your client pays, they choose person (KYC) or entity (KYB) on the link. An individual check is $20. A company, trust, or SMSF check is $40. You can add a service charge of $0, $25, $50, or $100 on that verification only. When your workspace pays, you choose person or entity before the invite is emailed, and there is no service charge. The report email is the account that created the API key.
• Get verification. Looks up one verification in this workspace by id or reference.
• Resend invite. Emails the same link again. Enter the verification id. Wait a minute between sends. When your workspace pays, pay for the verification before you resend.

If a key stops working

• Revoke removes access immediately. Hooks that used that key stop as well.
• Paste a new key into n8n. The old credential does not pick up the new key on its own.
• The FreeAML node in n8n is listed after n8n verifies it. Until then, an n8n admin who installed the FreeAML node can still connect with your key.