Skip to main content

How to delete notes from your contacts using the folk API

This guide explains how to delete notes from contacts in bulk using the folk API and n8n, without needing to code.

Updated yesterday

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

  1. Download and open the workflow file: 👉🏼 Template Folk Delete Note.json

  2. In n8n, click Import workflow

  3. Select the JSON file you downloaded

  4. You’ll now see the workflow appear with all the necessary steps pre-configured


🔑 Step 2 — Add your folk API key

  1. Open the node called “API KEY”

  2. Replace the empty value with your API key:

    { "api-key": "YOUR_FOLK_API_KEY_HERE" }
  3. You can find your API key in folk → Settings → API


🧍 Step 3 — Target the right group

  1. Open the node “API LIST PEOPLE - Folk Api”

  2. In the section “JSON Query”, replace grp_.. with the ID of your group, for example:

    "filter[groups][in][id]": "grp_d5a8dfc"
  3. To delete notes from all contacts, simply remove that line.


🚀 Step 4 — Run the workflow

  1. At the top of n8n, click “Execute Workflow”

  2. 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)

  3. 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.

Did this answer your question?