Skip to main content
Ready-to-LaunchCustom Builds
Start Building Now

Tax Form Events

Tax form events notify you when tax forms are created or updated. Subscribe to these webhooks to stay informed about tax document availability for your customers.

taxForm.created​

Occurs when a Tax Form is created successfully.

Attributes​

createdAt
RFC3339 Date string
The date the event was created.
taxYear
ISO8601 Year string
The tax year of the form, formatted YYYY.
formType
string
The type of the tax form (e.g., 1099-INT).
revision
integer
The revision number of the tax form (starts at 0).

Relationships​

taxForm
JSON:API Relationship
The Tax Form that was created.
customer
JSON:API Relationship
The Customer associated with the tax form.
Example taxForm.created payload:
{
  "data": [
    {
      "id": "1",
      "type": "taxForm.created",
      "attributes": {
        "createdAt": "2021-11-29T17:23:08.778Z",
        "taxYear": "2023",
        "formType": "1099-INT",
        "revision": 0
      },
      "relationships": {
        "taxForm": {
          "data": {
            "id": "18",
            "type": "taxForm"
          }
        },
        "customer": {
          "data": {
            "id": "10000",
            "type": "customer"
          }
        }
      }
    }
  ]
}

taxForm.updated​

Occurs when an updated Tax Form is available. This typically happens in response to a request to amend an issued form.

Attributes​

createdAt
RFC3339 Date string
The date the event was created.
taxYear
ISO8601 Year string
The tax year of the form, formatted YYYY.
formType
string
The type of the tax form (e.g., 1099-INT).
revision
integer
The revision number of the tax form (incremented from previous version).

Relationships​

taxForm
JSON:API Relationship
The Tax Form that was updated.
customer
JSON:API Relationship
The Customer associated with the tax form.
Example taxForm.updated payload:
{
  "data": [
    {
      "id": "1",
      "type": "taxForm.updated",
      "attributes": {
        "createdAt": "2021-11-29T17:23:08.778Z",
        "taxYear": "2023",
        "formType": "1099-INT",
        "revision": 1
      },
      "relationships": {
        "taxForm": {
          "data": {
            "id": "18",
            "type": "taxForm"
          }
        },
        "customer": {
          "data": {
            "id": "10000",
            "type": "customer"
          }
        }
      }
    }
  ]
}