Submit payroll migration files for a legal entity

POST

/gp/legal-entities/:legal_entity_id/payroll-migration-imports

POST

/rest/gp/legal-entities/:legal_entity_id/payroll-migration-imports

$ curl -X POST https://api.letsdeel.com/rest/gp/legal-entities/9a1f0e77-3c22-4b8d-8e64-2b0f5d9c1a44/payroll-migration-imports \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "data": {
>     "files": [
>       {
>         "file_id": "V1StGXR8_Z5jdHi6B-myT",
>         "one_time_secret": "b7c2e91-A_z.9"
>       }
>     ]
>   }
> }'

1 {
2   "data": {
3     "files": [
4       {
5         "file_id": "V1StGXR8_Z5jdHi6B-myT",
6         "file_name": "Revolut IE (YTD) 2026.csv",
7         "file_size": 524288,
8         "mime_type": "text/csv",
9         "uploaded_at": "2026-01-15T09:30:00.000Z"
10       }
11     ],
12     "status": "SUBMITTED",
13     "import_id": "2f8c9a41-6b3e-4d0a-9f21-77c1e0a5b3d8",
14     "created_at": "2026-01-15T09:30:00.000Z",
15     "submitted_at": "2026-01-15T09:30:00.000Z",
16     "legal_entity_id": "9a1f0e77-3c22-4b8d-8e64-2b0f5d9c1a44"
17   }
18 }

Attach year-to-date payroll files to a legal entity and submit them for review, in one call. Upload each file to the Deel file service first and pass the file id and one-time secret it returns; the file bytes never reach this endpoint. Atomic: if any file is rejected, nothing is stored. Error codes: 400 FILE_CLAIM_FAILED (not scanned yet, or the secret is invalid or spent), 403 FORBIDDEN, 403 PAYROLL_MIGRATION_IMPORT_DISABLED, 404 NOT_FOUND, 409 DUPLICATE_IMPORT_FILE (repeated, or already attached).

Token scopes: global-payroll: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.

$ curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>   -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.deel.training/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/

Path parameters

legal_entity_idstringRequiredformat: "uuid"

The unique identifier of the legal entity the payroll migration files belong to.

Request

This endpoint expects an object.

dataobjectRequired

The payroll migration files to submit.

Response

dataobject

The submitted payroll migration import.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error

$	curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'