Sometimes, you may want to clean up old or irrelevant notes from your workspace — for example after a failed import.
🧭 What you’ll achieve
By following this guide, you’ll:
Automatically find all people in a specific group
List all notes attached to each contact
Delete all those notes in a few clicks
⚙️ What you’ll need
✅ A folk API key
✅ The Group ID of the contacts you want to clean
✅ Access to n8n (either n8n.io Cloud or a self-hosted version)
💡 Don’t worry — you don’t need to code. You’ll just plug your API key and group ID in a ready-made template.
🧠 How it works
The workflow asks folk’s API for the list of people in your group
For each person, it looks up all their notes
Each note is then deleted automatically using the
DELETE /notes/{note_id}
endpoint
No coding, no manual clicking — just one clean sweep.
📦 Step 1 — Import the template into n8n
Download and open the workflow file: 👉🏼 Template Folk Delete Note.json
In n8n, click Import workflow
Select the JSON file you downloaded
You’ll now see the workflow appear with all the necessary steps pre-configured
🔑 Step 2 — Add your folk API key
Open the node called “API KEY”
Replace the empty value with your API key:
{ "api-key": "YOUR_FOLK_API_KEY_HERE" }
You can find your API key in folk → Settings → API
🧍 Step 3 — Target the right group
Open the node “API LIST PEOPLE - Folk Api”
In the section “JSON Query”, replace
grp_..
with the ID of your group, for example:"filter[groups][in][id]": "grp_d5a8dfc"
To delete notes from all contacts, simply remove that line.
🚀 Step 4 — Run the workflow
At the top of n8n, click “Execute Workflow”
The automation will:
Find each person in your selected group
Fetch their notes
Delete each note, one by one (with a short delay between each request to stay safe with the API)
When finished, all notes from your selected contacts will be deleted 🎉
⚠️ Important notes
Deleted notes can’t be recovered, so make sure you’re targeting the right group.
If you only want to delete some notes (e.g., older ones), you can modify the “List notes per person” node to add filters like:
"createdAt[lt]": "2024-01-01"
To run this cleanup on a regular basis, you can add a Schedule Trigger instead of the manual one.
✨ You’re done!
That’s it — your contacts are now clean and tidy.
If you need help setting this up, just reach out to the folk team via chat or at support@folk.app — we’ll guide you through it.