TwentyDEV icon

TwentyDEV

Consume the Twenty API

Actions252

Overview

This node allows you to create multiple workflow runs in bulk via the "Create Many Workflow Runs" operation. It is useful when you need to programmatically start several instances of workflows with specific configurations or statuses at once, rather than triggering them individually. For example, you might use this node to initiate batch processing jobs, automate testing scenarios by running workflows multiple times, or schedule multiple workflow executions with different parameters.

Properties

Name Meaning
Depth Determines how much related nested data is included in the response:
- 0: Only the primary workflow run object.
- 1: The primary object plus its directly related objects.
- 2: Includes related objects of those related objects as well.
Body JSON object representing the workflow run(s) to create. Example default includes:
- status: Status of the workflow run (e.g., "NOT_STARTED").
- name: Name assigned to the workflow run. You can customize this JSON to specify other properties of the workflow run.

Output

The node outputs JSON data representing the created workflow runs. The structure corresponds to the API response and includes the workflow run details according to the specified depth level. This may include nested related objects depending on the depth setting. There is no binary output.

Dependencies

  • Requires an API key credential for authenticating with the external Twenty API service.
  • The node uses a base URL configured from credentials.
  • The request headers expect JSON content type and accept JSON responses.

Troubleshooting

  • Invalid JSON in Body: If the JSON provided in the "Body" property is malformed, the node will fail. Ensure valid JSON syntax.
  • Authentication Errors: Missing or incorrect API credentials will cause authentication failures. Verify that the API key and domain are correctly set in the node credentials.
  • API Limits or Permissions: Creating many workflow runs at once may hit API rate limits or require specific permissions. Check your API plan and user rights.
  • Depth Parameter Misuse: Setting an unsupported depth value could lead to unexpected responses or errors. Use only 0, 1, or 2 as defined.

Links and References

Discussion