Generate timesheet upload url | Deel

curl -X POST https://api.letsdeel.com/rest/v2/time-tracking/timesheets/upload-url \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "data": {
    "end_date": "2025-06-30",
    "file_name": "june_timesheets.csv",
    "start_date": "2025-06-01",
    "contract_id": "JvUc0hPV"
  }
}'

{
  "data": {
    "id": "880e8400-e29b-41d4-a716-446655440003",
    "created_at": "2025-11-07T18:00:00.000Z",
    "updated_at": "2025-11-07T18:00:00.000Z",
    "upload_url": "https://my-unique-upload-bucket.s3.amazonaws.com/uploads/document.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20251107%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20251107T180000Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",
    "upload_fields": {
      "key": "uploads/document.pdf",
      "bucket": "my-unique-upload-bucket",
      "Content-Type": "text/csv"
    }
  }
}

Accepts timesheet file metadata and returns a pre-signed upload_url together with a new timesheet record id. Currently limited to EOR contracts. Token scopes: time-tracking:write

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

1 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Request

timesheet information needed for uploading timesheet file

dataobjectRequired

Response

Timesheet created successfully. Returns upload URL, upload form fields, and timesheet ID.

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error

1	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2	-H 'Authorization: Bearer YOUR-TOKEN-HERE'