Tax Form Webhook 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

Name	Type	Description
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

Name	Type	Description
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

Name	Type	Description
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

Name	Type	Description
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"
          }
        }
      }
    }
  ]
}