Creating a Registration Request

Overview

In order to have Middesk complete tax registrations for specified jurisdictions on the behalf of an employer, one of the options available is to utilize the Middesk API Registration Request endpoint.

To create a Registration Request for an employer to fill out and have the request process deliverables (e.g. Registration-related items, UI account number, UI tax rates, etc) via the Middesk API, we recommend an implementation based on this flow.

1. Search Jurisdictions

Requesting a registration requires a Jurisdiction -- call this 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 jurisdictions can be encompassed ranges from the local level such as a city up to the state level such as for Unemployment Insurance or Withholding.

2. Create Registration Request

Call this endpoint in order to create the form to send over to the end company.

1. End employer will use the invite_link provided and complete the Middesk intake flow.
2. The submission of the Registration Request will specify a set of jurisdictions on the Middesk side which we will complete the registrations for.

This endpoint requires company info such as email and name, and the chosen state / jurisdictions. Here you can pass in the slug found in Step (1) to the jurisdictions field to specify which jurisdictions the we will be complete registrations for.

📘

NOTE:

If nothing is passed into the jurisdictions field: By default, Middesk will create a Registration Request for all Unemployment/Withholding jurisdictions in the given state.

3. View Registration Request Status

To view the current status of the registration request and gather info on any updates related to the deliverables, we have two recommended options:

3a) Call the GET Registration Request endpoint manually.

Call this endpoint to retrieve any current info about the registration request manually such as the status.

3b) Create a webhook to listen to updates for a Registration

Follow this API Reference for more info on how to build out the webhook to get up to date information immediately in your systems.