Workboard - SJI icon

Workboard - SJI

Interact with Workboard API

Team → Create

AI-generated

Overview

This node interacts with the Workboard API to perform various operations on different resources such as users, teams, goals, metrics, activities, workstreams, datastreams, tags, and webhooks. Specifically, for the 'Team' resource with the 'Create' operation, it allows users to create a new team by sending the relevant data to the Workboard API. This is useful for automating team management workflows, such as adding new teams programmatically within an organization's Workboard environment.

Use Case Examples

  1. Automatically create a new team in Workboard when a new project is initiated.
  2. Integrate with other systems to sync team data and create teams dynamically based on external triggers.

Properties

Name Meaning
Additional Fields Optional fields to provide extra information when creating a team, such as activity description, notes, owner, workstream, team name, due date, state, priority, rating, effort, tags, and comments. These fields allow detailed customization of the team creation request.

Output

JSON

  • success - Indicates whether the team creation was successful.
  • team_id - The unique identifier of the newly created team (if returned by the API).
  • message - Additional message or information returned by the API after creating the team.

Dependencies

  • Workboard API with JWT Bearer Token authentication

Troubleshooting

  • Ensure the API credentials (JWT token) are correctly configured and valid to avoid authentication errors.
  • Verify that all required fields for creating a team are provided; missing mandatory fields may cause the API to reject the request.
  • Check the API base URL configuration if the node cannot reach the Workboard API endpoint.
  • If the API returns an error, the node will throw a NodeApiError with the message from the API; review the error message for specific issues such as permission denied or invalid data format.

Links

  • Workboard API Documentation - Official API documentation for Workboard, useful for understanding available endpoints and data formats.

Discussion