Skip to main content
Version: 2.0.0

Form 1099 Auto-Generation

This webhook can be configured to receive real-time notifications when TaxBandits has auto-generated 1099 forms based on the transactions recorded.

Steps to configure​

  1. Log in to Developer Console
    Navigate to 'Settings' → 'Webhook Notifications'.

  2. Add a webhook
    Click 'Add Webhook' and select the event type 'Form 1099 Auto-Generation'.

Form 1099 Auto Generation

  1. Provide a callback URL
    Enter a valid HTTPS callback URL (maximum 500 characters). Ensure that your callback URL follows these best practices.

    • The API validates this URL by sending a sample JSON payload.
    • The webhook will be activated only after your endpoint responds with an HTTP 200 status code.

  2. Configure a notification email
    Provide a notification email address. TaxBandits will use this email to alert you if webhook delivery attempts fail.

Statuses available​

The following are the different statuses available.

  • Draft - The draft version of 1099 forms are generated.
  • Transmitted - The 1099 forms are transmitted to the IRS and respective stage agencies.

Receiving webhook requests​

Once the webhook is configured and the callback URL is successfully authenticated, TaxBandits will send an HTTP POST request to your callback URL whenever a filing status changes.

Each request contains a JSON payload with submission details and record-level status information.

Sample webhook payload​

    {
        "SubmissionId": "6ceafae2-c830-411c-b1c0-86f5db363104",
        "BusinessId": "6a0628bc-7b9c-40c6-9a39-b16848c45b88",
        "PayerRef": "178956",
        "TaxYear": "2023",
        "NoOf1099s": 1,
        "Form1099NECRecords":[
            {
                "RecordId": "0b4312b2-6d39-40a2-a16b-b28ede05f337",
                "RecipientId": "731a46b8-f4a7-404d-abeb-5a972996f685",
                "PayeeRef": "478596",
                "NECBox1": 5263.82,
                "NECBox4": 0,
                "FederalReturn": {
                    "Status": "DRAFT",
                    "StatusTs": "2023-12-11 08:08:02 -05:00",
                    "Info": null
                }
            }
        ]
    }

Responding to webhook requests​

Your application must respond with HTTP 200 OK to acknowledge receipt of a webhook request.

  • Any response other than 200 is treated as a failed delivery
  • HTTP redirects (301) are not supported and are treated as errors
  • Your endpoint must respond within 5 seconds, or the request is considered a timeout

If a webhook delivery fails or times out, TaxBandits will retry the request up to 9 times within 24 hours.

Validating webhook requests​

Before processing a webhook payload, you must verify that the request originated from TaxBandits.Refer to the Webhook validation documentation to learn how to authenticate incoming webhook requests.