SuggestTimecardsAction
Returns a resource's scheduled assignments, and optional scheduled hours, for the week. Enables the user to see which assignments are suggested to log time against. These are only optional suggestions. This action does not create timecards.
| Property | Value |
|---|
| Label | Suggest Timecards |
| Category | — |
| Since | Summer 2026 |
| Read-only | Yes |
| Supports Agents | Yes |
| Supports Flows | No |
| Async Action | No |
| Keywords | timesheet, recommendations, prefill |
Request Parameters
| Field | Type | Label | Description | Required |
|---|
resourceId | Id | Resource ID | The ID of the resource (Contact) to suggest a timecard for. | Yes |
startDate | Date | Week Start Date | The first day of the seven-day period to suggest timecards for. Suggestions cover this date and the following six days. | Yes |
withScheduledHours | Boolean | With Scheduled Hours | If true, includes the scheduled hours per assignment. The default value is True. | No |
excludedAssignmentIds | List<Id> | Excluded Assignment IDs | Assignment IDs to exclude from the suggestion. If you are aware of timecards to be excluded, such as existing timecards for the week, provide the assignment ID to prevent them being suggested again. | No |
Response Parameters
| Field | Type | Label | Description | Required |
|---|
suggestions | List<String> | Suggestions | The suggested assignments the resource can log time against for the week. Each element is a JSON string containing the following: the assignment ID, project ID, scheduled hours per weekday and the total scheduled hours. | No |
| 