Delete All Swift Users From Group
Overview
| Field | Value |
|---|---|
| Workflow ID | l0KQdZd8IGiJNuLa |
| n8n URL | https://n8n.pbr.org.au/workflow/l0KQdZd8IGiJNuLa |
| Status | Inactive — manual execution only |
| Trigger | Manual (Execute Workflow button in n8n) |
| Systems | Swift Digital |
Purpose
This is a utility workflow used to bulk-delete all contacts from a specified Swift Digital contact group. It is not scheduled and must be manually executed. Before running, the target group ID must be set in the n8n Global Constants node.
Warning: This workflow calls the Swift Digital contact DELETE API, which permanently removes the contacts from Swift Digital entirely — it does not merely remove them from the group. Use with care.
How It Works
- Manual trigger — workflow is started manually from within n8n.
- Global Constants — reads the target group ID(s) from the n8n Global Constants node. The
constantsfield is expected to contain one or more group IDs. - Split Out group IDs — if multiple group IDs are present in constants, they are split into individual items for iteration.
- Get Users in Group — calls
GET https://v3.api.swiftdigital.com.au/request/mailhouse/mailgroup/readmemberswith the group ID to retrieve all contact IDs in the group. - Split Out contact IDs — splits the returned array of contact IDs into individual items.
- Remove Users from Swift — calls
DELETE https://v3.api.swiftdigital.com.au/request/mailhouse/contact/deletefor each contact ID, permanently deleting them from Swift Digital.
Usage Instructions
- Open the workflow in n8n: https://n8n.pbr.org.au/workflow/l0KQdZd8IGiJNuLa
- Open the Global Constants node and set the
constantsvalue to the Swift Digital group ID(s) you want to clear. - Save the workflow.
- Click Execute Workflow.
- Monitor the execution to confirm all contacts were removed.
Do not activate (publish) this workflow. It should always remain inactive and only be run on demand.
Nodes
| Node | Type | Purpose |
|---|---|---|
| When clicking Execute workflow | Manual Trigger | Entry point — started manually only |
| Global Constants | Global Constants | Provides the target group ID(s) |
| Split Out1 | Split Out (constants) | Iterates over group IDs if multiple are configured |
| Get Users in Group | HTTP Request (GET) | Retrieves all contact IDs in the target group from Swift Digital |
| Split Out | Split Out (contact_ids) | Splits the contact ID array into individual items |
| Remove Users from Swift | HTTP Request (DELETE) | Permanently deletes each contact from Swift Digital |
Credentials
| Credential | Type | Used For |
|---|---|---|
| Swift Digital OAuth2 | OAuth2 | All Swift Digital API calls |
Maintenance Notes
- This workflow must remain inactive at all times. Do not publish it.
- The target group ID must be manually set in Global Constants before each run — it is not persisted between executions.
- This workflow deletes contacts from Swift Digital entirely, not just from a group. Ensure this is the intended behaviour before running. If you only need to remove contacts from a group without deleting them, the Swift Digital API endpoint
/request/mailhouse/mailgroup/removemembersshould be used instead — this would require a workflow modification. - The BetterImpact > Swift User Ingest workflow will re-create contacts on its next run if the deleted users still exist as active members in BetterImpact. This workflow is therefore typically used to reset a group before a clean resync.