Dingtalk NodeInstall

Summary

Create a new to-do task in DingTalk for a specified user, either by submitting form parameters or a custom JSON body.

Inputs

• 用户 Union ID (required) — The unionId of the user in whose to-do list the task will be created. This must be supplied.
• 不使用凭证中的操作人 — If set to true, you can manually specify the operator instead of using the credential's operator.
• 操作人的unionId — The unionId of the operator performing the action. Required if '不使用凭证中的操作人' is true.
• 发送请求体 (required) — Select how the request body is sent: either using form fields or a raw JSON body.
• 请求体JSON (required) — A JSON object defining the to-do task details, used when '发送请求体' is set to 'json'.
• 业务系统唯一 ID — Unique ID from your business system for the to-do task, used for idempotency and later queries by sourceId. Used when sending form data.
• 标题 (required) — Title of the to-do task (subject). Required when sending form data.
• 创建人 Union ID — UnionId of the creator of the task. Defaults to operator unionId if empty when sending form data.
• 描述 — Description of the task. Used when sending form data.
• 截止时间 — Due time for the task, either as ISO-8601 string or millisecond timestamp. Used when sending form data.
• 执行人 Union ID 列表 — Comma-separated list of executor unionIds. Used when sending form data.
• 参与人 Union ID 列表 — Comma-separated list of participant unionIds. Used when sending form data.
• 移动端详情页 URL — Mobile detail page URL to open when clicking the task in DingTalk. Used when sending form data.
• PC 端详情页 URL — PC detail page URL to open; if empty, the mobile URL is reused. Used when sending form data.
• 优先级 — Priority of the task with options (low 10, normal 20, high 30, urgent 40). Defaults to normal (20). Used when sending form data.
• 仅执行人可见 — If true, the task is visible only to executors. Used when sending form data.
• 发送 DING 通知 — If true, sends a DING notification for the task. Used when sending form data.

Output shape

A JSON object representing the created to-do task as returned by DingTalk's API.

The output format depends on DingTalk's API response format for creating a task. The node supports two modes for sending the task data: as form fields or a raw JSON body. If '不使用凭证中的操作人' is true, ensure '操作人的unionId' is set, otherwise the operator from credentials is used. Dates can be provided as ISO-8601 strings or timestamps.

Examples

Example 1: Creating a to-do task with form parameters

Supply user unionId, subject, executorIds, and optionally description and dueTime; sendBody set to 'form'. Optionally override the operator by enabling '不使用凭证中的操作人' and providing operatorId.

Example 2: Creating a to-do task with raw JSON

Set sendBody to 'json' and provide the entire task definition as JSON in '请求体JSON', including sourceId, subject, creatorId, executorIds, participantIds, URLs, dueTime, and priority.

Links

• n8n community nodes installation guide