Attach payroll migration files to 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     "type": "YTD_HISTORICAL_INGESTION",
4     "files": [
5       {
6         "source": "EXTERNAL",
7         "file_id": "V1StGXR8_Z5jdHi6B-myT",
8         "file_name": "Revolut IE (YTD) 2026.csv",
9         "file_size": 524288,
10         "mime_type": "text/csv",
11         "uploaded_at": "2026-01-15T09:30:00.000Z",
12         "uploaded_by": 8313893
13       }
14     ],
15     "status": "SUBMITTED",
16     "import_id": "2f8c9a41-6b3e-4d0a-9f21-77c1e0a5b3d8",
17     "created_at": "2026-01-15T09:30:00.000Z",
18     "updated_at": "2026-01-15T09:30:00.000Z",
19     "submitted_at": "2026-01-15T09:30:00.000Z",
20     "submitted_by": 8313893,
21     "legal_entity_id": "9a1f0e77-3c22-4b8d-8e64-2b0f5d9c1a44"
22   }
23 }

Attach year-to-date payroll files to a legal entity’s payroll migration import, created on the first call. Upload each file to the Deel file service first and pass the id and secret it returns. The import stays IN_PROGRESS until submitted; attaching files to a submitted one reopens it. Atomic: one rejected file stores nothing. Error codes: 400 FILE_CLAIM_FAILED, 401 UNAUTHORIZED, 403 FORBIDDEN, 403 PAYROLL_MIGRATION_IMPORT_DISABLED, 404 NOT_FOUND, 409 DUPLICATE_IMPORT_FILE, 500 INTERNAL_SERVER_ERROR.

Token scopes: global-payroll:write

Attach year-to-date payroll files to a legal entity's payroll migration import, created on the first call. Upload each file to the Deel file service first and pass the id and secret it returns. The import stays IN_PROGRESS until submitted; attaching files to a submitted one reopens it. Atomic: one rejected file stores nothing. Error codes: 400 FILE_CLAIM_FAILED, 401 UNAUTHORIZED, 403 FORBIDDEN, 403 PAYROLL_MIGRATION_IMPORT_DISABLED, 404 NOT_FOUND, 409 DUPLICATE_IMPORT_FILE, 500 INTERNAL_SERVER_ERROR. **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 attach to the import.

Response

dataobject

The 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'