Deel: Create a timesheet entry — request body — body data

API reference · Contract 2026-10-27

SDK schema: Create a timesheet entry — request body — body data

Field	Type	Presence	Description and constraints
$	object	Root	Payload attributes required to create one timesheet entry with optional approval, preset, and grouping metadata.
contract_id	string	Required within parent	Unique Deel contract identifier (public id) that receives this timesheet entry line item.
date_submitted	string	Required within parent	Date the work was performed in ISO-8601 short-date format (YYYY-MM-DD) used for filtering and approvals. Format: date
description	string	Required within parent	Detailed human-readable explanation of the work performed that appears on the invoice and audit records. Default:
group_key	string or null	Optional	When provided, timesheets sharing the same group_key within the same payment cycle are merged into a single aggregated line item on the invoice. Requires is_auto_approved to be true. Maximum length: 300
hourly_report_preset_id	string or null	Optional	Identifier of an existing timesheet preset used to link a standardized hourly rate and label to this entry.
is_auto_approved	boolean	Optional	When true, the created timesheet entry skips manual approval and is approved immediately on creation.
quantity	number	Required within parent	Number of work units (typically hours) to record based on the scale defined in the associated contract work statement. Format: double Minimum: 0.01