Create a tax form for a contractor | Deel

Submit a new US tax form on behalf of a contractor against a specific client legal entity, typically during onboarding or when a fresh form must be recorded for a contractor/legal-entity pair. Select the form type based on the contractor’s US tax status: W-9 for US individuals or entities, W-8BEN for non-US individuals, W-8BEN-E for non-US entities. The contractor must have an active (non-terminated) contract with the legal entity, and only one tax form may exist per contractor/legal-entity pair.

Token scopes: worker:write

Submit a new US tax form on behalf of a contractor against a specific client legal entity, typically during onboarding or when a fresh form must be recorded for a contractor/legal-entity pair. Select the form type based on the contractor's US tax status: W-9 for US individuals or entities, W-8BEN for non-US individuals, W-8BEN-E for non-US entities. The contractor must have an active (non-terminated) contract with the legal entity, and only one tax form may exist per contractor/legal-entity pair. **Token scopes**: `worker: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

contractor_idstringRequiredformat: "uuid"

The public ID (UUID) of the contractor’s HRIS profile — not the contract ID or the IC profile ID.

Request

This endpoint expects an object.

dataobjectRequired

Response

Tax form created successfully.

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error

$	curl -X POST https://api.letsdeel.com/rest/rest/contractors/00000000-0000-0000-0000-000000000000/tax-forms \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"data": {
>	"city": "New York",
>	"address": "123 Main Street",
>	"country": "US",
>	"zip_code": "10001",
>	"form_type": "W9_INDIVIDUAL",
>	"last_name": "Doe",
>	"first_name": "John",
>	"tax_number": {
>	"type": "SSN",
>	"value": "219-09-9999"
>	},
>	"contractor_signature": "John Doe",
>	"client_legal_entity_id": "00000000-0000-0000-0000-000000000000"
>	}
>	}'

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

1	{
2	"data": {
3	"id": "00000000-0000-0000-0000-000000000000",
4	"created_at": "2026-01-15T12:00:00.000Z"
5	}
6	}