Description

n8n-nodes-smenso

Official n8n community node for smenso – the project management platform for teams and enterprises.

This node gives you full access to the smenso API directly from your n8n workflows: manage projects, tasks, time records, absences, status reports, permissions, and much more — without writing a single line of code.

—

Prerequisites

Before you can use this node, your smenso workspace needs the Enterprise Add-on “smenso Integration API” enabled. Contact your smenso account manager if you’re unsure whether this is active.

—

Authentication

This node uses a personal API token from the smenso Admin Center.

Step 1 — Generate an API Token

1. Open admin.smenso.cloud
2. Navigate to API Token
3. Click Create API Token
4. Select the workspace and set a validity period
5. Give the token a name (e.g. n8n integration)
6. Click Create
7. Copy the token immediately — it is only shown once

Step 2 — Find your Workspace Subdomain

Your workspace subdomain is the part before .smenso.cloud in your smenso URL.

> Example: if your URL is mycompany.smenso.cloud, your subdomain is mycompany

Step 3 — Set up the Credential in n8n

1. In n8n, open any workflow and add the smenso node
2. Click Credential for smenso API → Create New
3. Enter your Workspace subdomain (e.g. mycompany)
4. Paste your API Token
5. Click Save — n8n will verify the connection automatically

—

Important: Async Operations & Ticket Polling

Many write operations in smenso are asynchronous. Instead of returning the created/updated record immediately, the API returns a Ticket ID. Use the Settings / Utilities → Get Status Ticket operation to poll for the result.

Ticket status values:

| Status | Meaning |
|—|—|
| Started | Still processing — poll again after a short wait |
| Success | Operation completed successfully |
| Success with Errors | Partially completed — check details |
| Failed | Operation failed — check error details |

Tip: Add a Wait node (2–3 seconds) between the write operation and the ticket poll.

—

What this node can do

Resource: Project

| Operation | Description |
|—|—|
| Get Many | Retrieve all projects in the workspace. Optional filters: Project IDs, Language, Timezone, View ID. |
| Get | Retrieve a single project by its GUID. |
| Create | Create a new project (async). Required: Title, Phase ID, Type ID. |
| Update | Update an existing project (async). Required: Project ID. |
| Delete | Permanently delete a project. |
| Archive | Archive a project (async). |
| Unarchive | Restore an archived project (async). |
| Create From Template | Create a new project based on a template. Required: Template ID, Title, Folder, Project Type. |
| Update Master Data From Template | Apply template master data to an existing project. Required: Template ID, Project ID. |

—

Resource: Task

| Operation | Description |
|—|—|
| Get Many | Retrieve all tasks for a project. Required: Project ID. |
| Get Tree | Retrieve a task together with all its subtasks. Required: Project ID, Task ID. |
| Create | Create one or more tasks (async). Required: Project ID, Title. |
| Update | Update an existing task (async). Required: Task ID. |
| Delete | Permanently delete a task. Required: Task ID. |
| Create From Template | Create a task from a task template. Required: Template ID, Project ID. |
| Update Dependencies | Add or modify predecessor dependencies (PATCH). Required: Project ID, Task ID, dependencies JSON array. |
| Remove Dependencies | Remove predecessor dependencies. Required: Project ID, Task ID, predecessor Task IDs. |

—

Resource: Absence

| Operation | Description |
|—|—|
| Get Many | Retrieve all absences in the workspace. Optional: Language, Timezone. |
| Create | Create one or more absences (async). Required: User ID/Email, Absence Type ID/Name, Start Date, End Date, Status. |
| Update | Update an existing absence (async). Required: Absence ID. Supports External ID lookup. |
| Delete | Permanently delete an absence. Required: Absence ID. |

—

Resource: Time Record

| Operation | Description |
|—|—|
| Get Many | Retrieve all time records for a project. Required: Project ID. |
| Create | Create one or more time records (async). Required: Project ID, Task ID, User ID/Email, Date. |
| Update | Update an existing time record (async). Required: Time Record ID, Project ID. Supports External ID lookup. |
| Delete | Permanently delete a time record. Required: Time Record ID. |

—

Resource: Status Report

| Operation | Description |
|—|—|
| Create | Create a new status report (async). Required: Project ID, Title, Status Date, Overall Status ID (1–7). |
| Update | Update an existing status report (async). Required: Status Report ID, Project ID. |
| Delete | Permanently delete a status report. Required: Status Report ID. |
| Create From Template | Create a status report from a template. Required: Template ID, Project ID, Title, Progress (0–100). |

—

Resource: Comment

| Operation | Description |
|—|—|
| Get | Retrieve a single comment by its ID. |
| Get Many (Task) | Retrieve all comments for a task. Required: Task ID. |
| Get Many (Status Report) | Retrieve all comments for a status report. Required: Status Report ID. |
| Create (Task) | Create a comment on a task (async). Required: Task ID, Text. |
| Create (Status Report) | Create a comment on a status report (async). Required: Status Report ID, Text. |
| Update (Task) | Update a task comment (async). Required: Comment ID, Text. |
| Update (Status Report) | Update a status report comment (async). Required: Comment ID, Text. |
| Delete | Permanently delete a comment. Required: Comment ID. |

—

Resource: Folder

| Operation | Description |
|—|—|
| Get Many | Retrieve all folders for a project. Required: Project ID. |
| Create | Create one or more folders in a project (async). Required: Project ID, Name. |
| Update | Update an existing folder (async). Required: Project ID, Folder ID. |
| Delete | Permanently delete a folder. Required: Project ID, Folder ID. |

—

Resource: Attachment

| Operation | Description |
|—|—|
| Download | Download an attachment by ID. Required: Attachment ID. |
| Delete | Permanently delete an attachment. Required: Attachment ID. |
| Get Project Attachments | List all attachments for a project. Required: Project ID. |
| Get Task Attachments | List all attachments for a task. Required: Task ID. |
| Get Status Report Attachments | List all attachments for a status report. Required: Status Report ID. |

—

Resource: Flavor

Flavors are smenso’s custom fields — configurable additional data fields on projects, tasks, and time records.

| Operation | Description |
|—|—|
| Get Many | Retrieve all flavor definitions in the workspace. |
| Delete | Permanently delete a flavor definition. Required: Flavor ID. |

—

Resource: Permissions

| Operation | Description |
|—|—|
| Get Project Permissions | Retrieve access and privacy settings for a project. Required: Project ID. |
| Set Project Access | Add or remove access restrictions for a project. Required: Project ID. |
| Delete Project Access | Remove all access restrictions from a project. Required: Project ID. |
| Set Project Privacy | Set a project as private with specific user/team access. Required: Project ID. |
| Delete Project Privacy | Remove privacy restrictions from a project. Required: Project ID. |
| Get Task Permissions | Retrieve access and privacy settings for a task. Required: Task ID. |
| Set Task Access | Add or remove access restrictions on a task. Required: Task ID. |
| Delete Task Access | Remove all access restrictions from a task. Required: Task ID. |
| Set Task Privacy | Set a task as private with specific user/team access. Required: Task ID. |
| Delete Task Privacy | Remove privacy restrictions from a task. Required: Task ID. |

—

Resource: Settings / Utilities

#### Utilities

| Operation | Description |
|—|—|
| Get Timezones | Retrieve all supported timezone identifiers for use in other operations. |
| Get Status Ticket | Poll the processing result of any async operation. Required: Ticket ID. |

#### Members

| Operation | Description |
|—|—|
| Get Members | Retrieve member settings for all workspace members. |
| Update Member | Update flavor values for a specific member (async). Required: Member ID/Email, Flavors JSON. |

#### Absence Types

| Operation | Description |
|—|—|
| Get Absence Types | Retrieve all absence type definitions. |
| Get Absence Type | Retrieve a single absence type by ID. Required: Absence Type ID. |
| Create Absence Types | Create one or more absence type definitions (async). Required: Title, Type (limited/unlimited). |
| Update Absence Types | Update an absence type definition (async). Required: Absence Type ID. |
| Delete Absence Type | Permanently delete an absence type. Required: Absence Type ID. |

#### Working Times

| Operation | Description |
|—|—|
| Get Working Times (All) | Retrieve working time records for all workspace members. |
| Get Working Times (User) | Retrieve working time records for a specific user. Required: User ID/Email. |
| Create Working Times | Create a working time record for a user (async). Required: User ID/Email, Start Date. |
| Update Working Times | Update a working time record (async). Required: Daily Capacity ID. |
| Delete Working Time | Delete a working time record. Required: Daily Capacity ID. |

#### Workspace Invitations

| Operation | Description |
|—|—|
| Invite Members | Send an invitation to a new workspace member. Required: Email, Role. |
| Invite Guests | Send an invitation to a guest. Required: Email, Role. |

—

Resource: Reporting (Export)

Uses the smenso Reporting API. Supports JSON and CSV output. Timezone uses IANA format (e.g. Europe/Berlin).

| Operation | Description |
|—|—|
| Get Projects | Export all visible projects. Optional: View ID, Project Filter, Column Headers, Format. |
| Get Project | Export a single project report. Required: Project ID. |
| Get Tasks for Project | Export all tasks for a specific project. Required: Project ID. |
| Get Tasks by Filter | Export tasks across all projects by filter. Optional: Project Filter. |
| Get Time Records | Export time records. Required: Mode (all/my). |
| Get Absences | Export absence records. Required: Mode (all/my). |
| Get Teams | Export all teams in the workspace. |
| Get Flavors | Export all flavor definitions. |
| Get Member Settings | Export member settings including flavor values. |

—

Example Use Cases

• CRM → smenso: When a deal is won in HubSpot, automatically create a smenso project from a template
• HR → smenso: Sync approved absences from your HR system to smenso automatically
• Form → Task: Turn incoming contact form submissions into smenso tasks instantly
• Daily export: Pull all time records each morning and write them to Google Sheets or your ERP
• Auto status reports: Create and publish weekly status reports for all active projects on a schedule
• Onboarding: When a new employee is added in HR, create their smenso account, set working times, and assign projects

—

Resources

• smenso API Documentation
• smenso Integration API Swagger
• smenso Reporting API Swagger
• smenso Help Center
• n8n Community Nodes Documentation

—

License

MIT