create_connector
Create an Arc connector with a unique ID, connector type, and flow role (trigger, terminal, transform, or none) to set up data integration across workspaces.
Instructions
Create a new Arc connector. Requires connectorId, connectorType, and action. The action property defines the connector's role in flows. If workspaceId is not specified, connector is created in the default workspace.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Connector's role in flows (required). Trigger: starts flow (pulls/receives data). Terminal: ends flow (sends/stores data). Transform: processes data in middle of flow. None: for dual-role connectors like File that adapt to their position. | |
| logLevel | No | Log level: None, Error, Warning, Info, Debug, or Trace | |
| maxFiles | No | Maximum files to process per worker assignment | |
| maxWorkers | No | Maximum workers from pool for this connector | |
| connectorId | Yes | Unique identifier for the new connector (required) | |
| logMessages | No | Whether to keep message copies in Logs directory | |
| workspaceId | No | The workspace ID (defaults to 'default' if not specified) | |
| connectorType | Yes | Connector type (required). Always use the latest version of a connector when one exists — versioned types use the suffix 'v2', 'v3', etc. (e.g., use 'RESTv2' not 'REST', 'AS4v2' not 'AS4'). Other common types: 'AS2', 'FTP', 'SFTP', 'File', 'X12', 'MySQL'. | |
| automationSend | No | Whether to automatically process files in the Send folder | |
| receiveInterval | No | Interval for automatic file receiving. Use a plain number (in minutes) for simple schedules, e.g., '15' for every 15 minutes, '60' for every hour. For complex schedules use a 5-part cron expression, e.g., '0 2 * * *' for daily at 2 AM. | |
| saveToSentFolder | No | Whether to keep copies in Sent folder | |
| sentFolderScheme | No | Sent folder structure: Daily, Weekly, Monthly, or Yearly | |
| automationReceive | No | Whether to automatically receive files at specified interval | |
| logSubFolderScheme | No | Log folder structure: Daily, Weekly, Monthly, or Yearly | |
| automationMaxAttempts | No | Maximum retry attempts (0 for unlimited) | |
| automationRetryInterval | No | Time to wait after error before retry, in minutes |