Register an entity for payroll taxes
Partners can request tax registrations from employers. A registration request represents a single request for an employer to submit information to complete a state tax registration.
Partners can request registrations for their employers by providing a US state, either a company name (to create a new Middesk company) or a company ID (if already added as a child account through Middesk), and an employer’s email to send the registration invitation link to.
To have Middesk complete tax registrations for specified jurisdictions on behalf of an employer, use the Middesk Dashboard or POST /registration_requests endpoint.
Request registration with the Dashboard
Use the Middesk Dashboard or a reusable referral link to manage registrations without any development work. Initiate registrations, share the link with end users, and receive status updates directly within the Dashboard. Choose this option if you want quick onboarding with minimal setup.
Request registration with the API
To create a registration request for an employer to fill out and have the request process deliverables (for example, registration-related items, UI account number, UI tax rates, and so on) with the Middesk API, follow these steps:
Search jurisdictions
Requesting a registration requires a jurisdiction. Call the /jurisdictions/search endpoint to search for the jurisdiction needed.
From the payload response, retrieve the slug field from the respective necessary jurisdictions to use for the next step.
The scope of what a jurisdiction can encompass ranges from the local level such as a city up to the state level such as for unemployment insurance or withholding.
Create a registration request
To create the form to send to the end company, call the POST /registration_requests endpoint.
The end employer uses the invite_link provided and completes the Middesk intake flow.
The submission of the registration request specifies a set of jurisdictions on the Middesk side, which Middesk completes registrations for.
This endpoint requires company information like email and name, and the chosen state or jurisdictions.
To specify which jurisdictions to complete registrations for, pass in the slug from step 1 to the jurisdictions field.
If you want to pre-fill information on the intake flow for your employers you can provide the data in the body of the “create registration request” API call. List of values that can be pre-filled on the intake can be found here
jurisdictions field, Middesk creates a registration request for all unemployment and withholding jurisdictions in the given state.View the registration request status
To view the current status of the registration request and gather information on any updates related to the deliverables, like the current status, either:
- Call the GET /registration_requests endpoint manually, or
- Create a webhook to listen to updates for a registration
If you’re set up to receive registration_request webhooks, when the registration form is submitted by the employer, you receive an event alerting you of the submitted registration.
From there, as the associated Tax Registrations Items (created upon submission) are completed, you receive events with their tax ID values.
