Actions15
Overview
This node integrates with the Teamdeck API to manage projects, time entries, and bookings. Specifically for the Project - Create operation, it allows users to create a new project in Teamdeck by specifying essential details such as the project name and optional additional fields like description and color.
Common scenarios where this node is beneficial include:
- Automating project creation workflows when new initiatives start.
- Integrating project management systems with Teamdeck to synchronize project data.
- Quickly setting up projects programmatically based on external triggers or data sources.
For example, you could use this node to automatically create a new project in Teamdeck whenever a new client onboarding form is submitted, passing along relevant project details.
Properties
| Name | Meaning |
|---|---|
| Add Additional JSON | Whether to add extra JSON data from input to output, allowing custom data passthrough. |
| Additional JSON | The actual JSON data to pass through if "Add Additional JSON" is enabled. |
| Project Name | The name of the project to be created (required). |
| Additional Fields | Optional extra fields for the project: |
| - Description: A textual description of the project. | |
| - Color: Hex code representing the project's color. |
Output
The node outputs a JSON object representing the newly created project as returned by the Teamdeck API. This includes all standard project properties such as its unique ID, name, description, color, and any other metadata provided by the API.
If "Add Additional JSON" is enabled, the output JSON will also contain an additionalJson field that includes the passed-through custom JSON data.
No binary data output is produced by this operation.
Example output structure (simplified):
{
"id": "12345",
"name": "New Project",
"description": "Project description here",
"color": "#ff0000",
"additionalJson": { /* custom JSON if provided */ }
}
Dependencies
- Requires an API key credential for authenticating with the Teamdeck API.
- The node makes HTTP requests to
https://api.teamdeck.io/v1/projects. - No other external dependencies are required.
- Ensure the API key has permissions to create projects in Teamdeck.
Troubleshooting
- Missing Required Fields: If the "Project Name" is not provided, the API call will fail. Always ensure required fields are set.
- API Authentication Errors: Invalid or missing API keys will cause authentication failures. Verify the API key credential configuration.
- Invalid Additional Fields: Providing unsupported or incorrectly formatted additional fields may result in API errors.
- Unknown Operation Error: If the operation parameter is incorrect or unsupported, the node throws an error indicating an unknown operation.
- Invalid API Response: If the API returns unexpected data, the node will throw an "Invalid API response received" error.
- Continue On Fail: If enabled, the node will continue processing subsequent items even if some fail, returning error details in the output.