Plutio icon

Plutio

Consume Plutio API
Join our community

Actions20

Overview

The Plutio Project Create operation node allows you to create a new project in your Plutio workspace directly from n8n. This is useful for automating project management workflows, such as onboarding new clients, launching internal initiatives, or integrating with other systems (e.g., CRM, helpdesk) that trigger the creation of projects in Plutio.

Practical examples:

  • Automatically create a new Plutio project when a deal is won in your CRM.
  • Set up standardized projects using templates and custom fields for different client types.
  • Assign contributors to new projects based on form submissions or team availability.

Properties

Name Type Meaning
Options Collection A group of settings for the new project. Includes:
• Project Name (string): The name of the project.
• Template Name or ID (options): Select or specify a template to base the project on.
Custom Fields Fixed Collection Key-value pairs for custom project fields. Only accepts dates in YYYY-MM-DD format for date fields. Each entry includes:
• Custom Field Name or ID (options): Select/specify the field.
• Value Name or ID (string): Value for the field.
Contributors Fixed Collection List of users to assign as contributors to the project. Each entry includes:
• Contributors: Name or ID (options): Select or specify a user by name or ID.

Output

The node returns the JSON response from the Plutio API after creating the project. The structure typically includes:

{
  "_id": "string",          // Unique identifier of the created project
  "name": "string",         // Name of the project
  "templateId": "string",   // Template used (if any)
  "customFields": [ ... ],  // Array of custom field objects (if provided)
  "contributors": [ ... ],  // Array of contributor IDs (if provided)
  // ...other project properties as returned by Plutio
}
  • If the API call fails and "Continue On Fail" is enabled, the output will include an error property with the error message.

Dependencies

  • External Service: Requires access to the Plutio API.
  • API Credentials: You must configure valid Plutio API credentials (plutioApi) in n8n.
  • n8n Configuration: No additional environment variables are required beyond standard credential setup.

Troubleshooting

Common Issues:

  • Missing Required Fields: If "Project Name" is not provided, the API may reject the request.
  • Invalid Template or Contributor: Specifying a non-existent template or contributor ID/name will result in an error.
  • Custom Field Format: Dates for custom fields must be in YYYY-MM-DD format; otherwise, the API may return a validation error.

Error Messages:

  • "error": "Request failed with status code 401" – Check your Plutio API credentials.
  • "error": "Field X is required" – Ensure all mandatory fields are filled.
  • "error": "Invalid value for custom field" – Verify custom field values and formats.

Links and References

Discussion