March 8, 2021
September 29, 2021

Making document management easier with webhooks

by 
Vincent Gaviria
March 8, 2021
September 29, 2021

Making document management easier with webhooks

by 
Vincent Gaviria

Payroll requires a lot of complicated paperwork from both employers and the people they’re paying. A company needs to fill out multiple forms before it can start running payroll, every employee needs to provide withholding forms when they start, and then every quarter (and at year end) the company must generate and file tax forms with the relevant authorities. Multiply those forms across all 50 states and thousands of local jurisdictions, and you start to get a sense of why payroll is hard.

At Check, we’re guided by our mission to make paying people simple, and a big part of that commitment is managing this proverbial paper trail, making it accessible to developers. That’s why we manage and render all the tax and authorization documents related to companies, employees, and contractors — throughout the entire lifecycle. A new employee can submit withholding forms through Check Onboard, for example, get paid throughout the year, then the following January, Check will automatically generate and file that person’s W2 form with the government.

Of course, while we handle document management in the background, we also want to make it easy for teams using Check to track that activity, including when documents are submitted or generated. Beginning today, Check will send webhook events whenever company, employee, or contractor documents are created in our system. By listening to these events, you can also easily notify relevant parties when these documents are ready to be viewed — for example triggering an email to an employee that their W2 is available, or to a company that their quarterly tax documents have been filed. These sorts of webhooks are a great example of our platform-first approach to payroll, and the powerful workflows you can build on Check as a result.

Each webhook request payload will contain a snapshot of the newly created document resource. For example, when an employee fills out and submits their federal withholding form, you can expect an event that looks something like this:


{
    "event": "created"
    "data": {
        "employee": "emp_iwpKV8wu1KvaYsyxw38u",
        "filed_on": "2021-02-24",
        "id": "doc_wGhFZ4GV7E7ZgWQRKzKC",
        "jurisdiction": "FED",
        "label": "Federal W-4",
        "year": 2021
    }
}

By default, these events are already being sent to all configured webhooks. To distinguish these from other webhook events, like our payroll status updates, you can use the X-Topic header. For more information about our webhooks or documents, head over to our API documentation.

More from the check blog

November 18, 2021
November 18, 2021

Preparing for Year-end 2021

Payroll providers spend countless hours behind the scenes preparing for year-end, which unfortunately doesn’t mean wrapping presents. To help, we put together our Year-end Playbook for Partners, which breaks down the year end process and shares best practices and tips.
November 1, 2021
September 29, 2021

October Changelog

October's additions and updates to Check. Changes include Earnings Rate API, defining benefits at the company level, revamping Console's audit flow, and adding bulk employee creation to Console.
October 11, 2021
October 11, 2021

Observing World Mental Health Day at Check

Here at Check, we make paying people simple. With 54% of U.S. consumers living from paycheck to paycheck, getting paid is a source of worry for many people. Beyond the financial aspect, the impact jobs have on people’s lives goes much deeper. In observance of World Mental Health Day, we took time to recognize how intertwined our work life, personal life, and physical and mental well-being through a company-wide event.