Skip to content

Deel: Create a new task — request body — body data

Create a new task: request body, field body / data. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Create a new task — request body — body data

FieldTypePresenceDescription and constraints
$objectRoot
amountstringRequired within parentThe amount to be associated with the task, in the appropriate currency.
date_submittedModelRequired within parentExpand Create a new task — request body — body data date submitted
The date the task was submitted, in ISO 8601 format. Also accepts date-time (YYYY-MM-DDTHH:MM:SSZ).
descriptionstring or nullRequired within parentA description of the task.
group_keystring or nullOptionalWhen provided, tasks sharing the same group_key within the same payment cycle are merged into a single aggregated line item on the invoice. The group_key is used as the invoice line item description. Requires is_auto_approved to be true.
Maximum length: 300
hourly_report_preset_idstring or nullOptionalId of an existing TRACKING preset.
Format: uuid
is_auto_approvedbooleanOptionalIf true, the task will be automatically approved as part of the request. Required to be true when group_key is provided.

Referenced models: Create a new task — request body — body data date submitted

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.