Skip to content

timecards.reviewed

Crewsum sends timecards.reviewed when a reviewer approves or rejects timecards.

Event type

timecards.reviewed

When it is sent

The Review Timesheet API endpoint (POST /v1/timesheets/timesheets/review).
A reviewer submits a review from the approval link in a Crewsum approval email.

Crewsum sends the event only after the change is saved. A request that fails or is rejected sends no event. See Delivery for timing and retries.

Payload

data.timecards is an array with one item per reviewed timecard. timecard is the timecard after the review. review is the review that was submitted: one approved flag per day, an optional rejectionReason, and optional comments.

{
  "event": "timecards.reviewed",
  "data": {
    "timecards": [
      {
        "timecard": {
          "data": {
            "Saturday": {
              "isoDate": "2026-09-26",
              "hours": 0,
              "description": null,
              "review": null,
              "reviewComment": null
            },
            "Sunday": {
              "isoDate": "2026-09-27",
              "hours": 0,
              "description": null,
              "review": null,
              "reviewComment": null
            },
            "Monday": {
              "isoDate": "2026-09-28",
              "hours": 8,
              "description": "On-site survey",
              "review": true,
              "reviewComment": null
            },
            "Tuesday": {
              "isoDate": "2026-09-29",
              "hours": 8,
              "description": "On-site survey",
              "review": true,
              "reviewComment": null
            },
            "Wednesday": {
              "isoDate": "2026-09-30",
              "hours": 6,
              "description": "On-site survey",
              "review": true,
              "reviewComment": null
            },
            "Thursday": {
              "isoDate": "2026-10-01",
              "hours": 0,
              "description": null,
              "review": null,
              "reviewComment": null
            },
            "Friday": {
              "isoDate": "2026-10-02",
              "hours": 0,
              "description": null,
              "review": null,
              "reviewComment": null
            }
          },
          "managerComments": "Looks good",
          "clientId": "client-ghi123jkl4567890",
          "clientName": "Northwind Logistics",
          "projectId": "project-mno123pqr4567890",
          "projectName": "Warehouse Automation Rollout",
          "projectBillingCategory": "BILLABLE",
          "reviewedAt": "2026-09-30T09:41:27.000Z",
          "approverName": "Dana Whitfield",
          "approverEmail": "dana.whitfield@example.com",
          "status": "approved",
          "taskId": "task-pqr123stu4567890",
          "isDefault": false,
          "taskName": "Site Survey",
          "taskBillingCategory": "BILLABLE",
          "timesheetId": "acme#alex.rivera#20260926_20261002",
          "userFullName": "Alex Rivera",
          "userId": "acme#alex.rivera",
          "clientCustomFields": {
            "region": "West"
          },
          "projectCustomFields": {
            "poNumber": "PO-1042"
          }
        },
        "review": {
          "projectId": "project-mno123pqr4567890",
          "taskId": "task-pqr123stu4567890",
          "data": {
            "Saturday": {
              "date": "2026-09-26",
              "approved": true,
              "rejectionReason": null
            },
            "Sunday": {
              "date": "2026-09-27",
              "approved": true,
              "rejectionReason": null
            },
            "Monday": {
              "date": "2026-09-28",
              "approved": true,
              "rejectionReason": null
            },
            "Tuesday": {
              "date": "2026-09-29",
              "approved": true,
              "rejectionReason": null
            },
            "Wednesday": {
              "date": "2026-09-30",
              "approved": true,
              "rejectionReason": null
            },
            "Thursday": {
              "date": "2026-10-01",
              "approved": true,
              "rejectionReason": null
            },
            "Friday": {
              "date": "2026-10-02",
              "approved": true,
              "rejectionReason": null
            }
          },
          "comments": "Looks good",
          "clientCustomFields": {
            "region": "West"
          },
          "projectCustomFields": {
            "poNumber": "PO-1042"
          }
        }
      }
    ]
  }
}

Review Timesheet