n8n-nodes-swipeone

n8n community node for the SwipeOne API. Automate your contacts, deals, tasks, tags, events, and more directly from n8n workflows.

It works as a regular workflow node and as a tool for AI agents, so you can let an AI Agent read and update your SwipeOne data in natural language.

Table of Contents

• Installation
• Credentials
• Resources & Operations
• Operation Reference
• Features
• Usage Examples
• Use as an AI Agent tool
• Troubleshooting
• Compatibility
• Maintainers & Contributing
• License
• Links

Installation

1. Open your n8n instance
2. Go to Settings > Community Nodes
3. Select Install a community node
4. Enter n8n-nodes-swipeone and click Install

For self-hosted n8n, you can also install via npm:

npm install n8n-nodes-swipeone

See the n8n community nodes installation docs for more detail.

Credentials

You need two things from your SwipeOne account:

API Key

1. Click the workspace name in the top-left corner to open the menu
2. Go to Workspace Settings > API Keys
3. Click Create API Key, give it a name, and copy the key

Workspace ID

Your Workspace ID is visible in the URL when you're logged into SwipeOne:

https://app.swipeone.com/workspaces/{{WORKSPACE_ID}}/people

Copy the ID between /workspaces/ and /people.

---

In n8n, go to Credentials > Add Credential > search SwipeOne API, enter both values, and save. The credential test will verify your connection automatically.

Under the hood the node calls the SwipeOne API at https://api.swipeone.com/api and authenticates with your key via the x-api-key request header. Your key is stored encrypted by n8n and never appears in workflow output.

Resources & Operations

Resource	Operations
Contact	Create or Update, Get, Get Many, Search, Add or Update Status
Contact Property	Create, Get, Get Many
Deal	Create, Get, Search, Update, Delete
Event	Fire Event, Create Definition, Get Definitions, Get Many
Note	Create, Get, Get Many, Update
Pipeline	Create, Get, Get Many, Delete
Segment	Get, Get Many, Get Contacts
Tag	Create, Get, Get Many, Update, Add to Contact, Get Contacts
Task	Create, Get, Get Many, Update

Operation Reference

Every operation that returns a list (Get Many, Search, Get Contacts) supports a Return All toggle and a Limit — see Features for how pagination is handled.

Contact

Operation	Description
Create or Update	Create a contact, or update it if the email already exists. At least one of First Name, Full Name, or Email is required. Set any custom workspace property via Additional Properties.
Get	Fetch a single contact by ID (searchable dropdown).
Get Many	List contacts in the workspace.
Search	Filter contacts by one or more property conditions. Operators adapt to the property type (text, email, select, number, date, phone, etc.).
Add or Update Status	Set or change a contact's status. Status values load from your workspace.

Contact Property

Operation	Description
Create	Define a new custom contact property.
Get	Fetch a single contact property.
Get Many	List all contact properties (built-in and custom) in the workspace.

Deal

Operation	Description
Create	Create a deal. Select a pipeline and stage from cascading dropdowns, link a contact, and set the deal value.
Get	Fetch a single deal by ID.
Search	Filter deals by pipeline, stage, and property conditions.
Update	Update an existing deal's fields, stage, or value.
Delete	Delete a deal.

Event

Operation	Description
Fire Event	Record a custom event for a contact. Select the event type from your workspace definitions and pass any event properties.
Create Definition	Create a new custom event definition (the event schema).
Get Definitions	List all event definitions and their properties.
Get Many	List the events recorded for a given contact.

Note

Operation	Description
Create	Add a note to a contact. Supports rich-text (Tiptap/ProseMirror JSON) content.
Get	Fetch a single note.
Get Many	List notes for a contact.
Update	Edit an existing note.

Pipeline

Operation	Description
Create	Create a deal pipeline.
Get	Fetch a single pipeline (including its stages).
Get Many	List all pipelines.
Delete	Delete a pipeline.

Segment

Operation	Description
Get	Fetch a single segment.
Get Many	List all segments.
Get Contacts	List the contacts that belong to a segment.

Tag

Operation	Description
Create	Create a tag.
Get	Fetch a single tag.
Get Many	List all tags.
Update	Rename or update a tag.
Add to Contact	Apply tags to a contact (replaces the contact's existing tags).
Get Contacts	List contacts that carry a given tag.

Task

Operation	Description
Create	Create a task, optionally linked to a contact, with a due date and assignee.
Get	Fetch a single task.
Get Many	List tasks.
Update	Update a task's fields or mark it complete.

Features

• Smart dropdowns — Select contacts, deals, notes, tasks, tags, and pipelines from searchable dropdown lists instead of pasting IDs.
• Cascading fields — Pipeline stages auto-update when you select a different pipeline. Search operators adapt to each property's type.
• Workspace-aware properties — Custom contact properties, event definitions, statuses, and tags are loaded live from your SwipeOne workspace.
• Pagination built-in — "Get Many", "Search", and "Get Contacts" handle pagination automatically. Turn on Return All to fetch every record, or set a Limit (default 100 per page). The node uses cursor- or page-based pagination as required by each endpoint.

Usage Examples

Create a contact and add a tag

1. Add a SwipeOne node > Resource: Contact > Operation: Create or Update
2. Fill in email, first name, last name
3. Add a second SwipeOne node > Resource: Tag > Operation: Add to Contact
4. Select the contact and tag from the dropdowns

Fire a custom event

1. Add a SwipeOne node > Resource: Event > Operation: Fire Event
2. Select the event type from the dropdown (loads your custom event definitions)
3. Choose the contact by name or email
4. Fill in any event properties

Build a deal pipeline workflow

1. Add a SwipeOne node > Resource: Deal > Operation: Create
2. Select a pipeline and stage from the cascading dropdowns
3. Link it to a contact and set the deal value

Use as an AI Agent tool

This node is usable as a tool, so it can be attached to an n8n AI Agent. The agent can then call SwipeOne operations on its own — for example "find the contact john@acme.com and create a follow-up task for tomorrow." Add the SwipeOne node to the agent's tool list and the agent picks the resource, operation, and parameters from your prompt.

Troubleshooting

• Credential test fails — Double-check the Workspace ID (the segment between /workspaces/ and /people in the app URL) and that the API key is active in Workspace Settings > API Keys. The key must belong to the same workspace.
• Dropdowns are empty — The node loads dropdown values from the API using your credential. If a list is empty, confirm the credential is selected and valid, and that the workspace actually contains that data (e.g. no tags yet means an empty Tag dropdown).
• Only 100 records returned — List operations return one page by default. Enable Return All to fetch every record, or raise the Limit.
• x-api-key / 401 errors — Regenerate the API key in SwipeOne and update the n8n credential.

Compatibility

• Requires n8n v1.54.4 or later
• Node.js 22+

Maintainers & Contributing

This is a community node, maintained by a member of the SwipeOne team.

Contributions are welcome! Open an issue or pull request on GitHub — bug reports, new operations, and docs improvements are all appreciated.

License

MIT

Links

• SwipeOne — email marketing platform
• SwipeOne API Docs
• n8n Community Nodes Docs
• Changelog