For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.

Support Deel Home

Overview Platform Employer of Record Contractors Global Payroll HR Embedded Deel IT API Reference Changelog

Overview Platform Employer of Record Contractors Global Payroll HR Embedded Deel IT API Reference Changelog

Resources
Platform
Endpoints

Introduction
Screenings
Immigration
Event: Immigration Case Process Status Update
Event: Immigration Case Renewal Created
Event: Engage Learning Journeys Assignments Created
Event: Engage Learning Journeys Assignments Reminded
Event: Oauth2 Token Revoked
Event: Onboarding Checklist Updated
Event: Onboarding Status Updated
Event: Payment Statement Initiated
Event: Payment Statement Mark Paid
Event: Profile KYC Changed
Event: Background Check Result Available
Event: Tax Document Available
Event: Tax Document Deleted

Support Deel Home

Endpoints Tax Documents

Event: Tax Document Available

Payload

{
  "data": {
    "meta": {
      "event_type": "tax.document.available",
      "event_type_id": "3455d332-0c09-4a62-a69f-b6cd0c56a596",
      "organization_id": "c2f26732-e747-4776-8a21-b31c379f2356",
      "organization_name": "Deel",
      "tracking_id": "d09a72b0002191b65de3a453d187f1a7"
    },
    "resource": [
      {
        "contract_oid": "123abc1",
        "country": "US",
        "id": 434078,
        "month": null,
        "status": "PUBLISHED",
        "document_type": "W-9",
        "year": 2024
      }
    ]
  },
  "timestamp": "2025-02-05T15:39:38.070Z"
}

Triggered when a tax document is published. The payload includes the document along with its country, period, and type.

Was this page helpful?

Event: Tax Document Deleted

Payload

The payload of this webhook request is an object.

dataobjectOptional

timestampstringOptional

Response

200

Return a 200 status to indicate that the data was received successfully.