There are 2 ways to create a Registration Request for your Employers:

  1. If the employer company has not yet been added to Middesk
  2. If the employer company has already been added to Middesk (from a previous Registration Request)

Option 1:
If the employer company has not yet been added you will need to supply the "company_name" as a param to the API request. We will create a Child Company under your Partner account and return the "company_id" in the successful Registration Request response.

Option 2:
If the employer company has already had a Registration Request added to it in Middesk you can simply provide the "company_id" as a param to the API request and the new Registration Request will be added to the same company as before. If there are multiple active Registration Requests for this company the employer will be prompted to complete all of them from the invite_link sent.

Upon success (201) the employer will receive an email from Middesk with the link to complete the Registration Request.

In order to track the Registration Request's lifecycle you can register to receive Registration Request Webhooks.

API Response Keys

API Response KeyDescription
idMiddesk Registration Request ID.

Used to match incoming Registration Request Webhooks.
stateUS State Abbreviation which Tax Registration was requested for. Example: "CA"
company_idMiddesk Company ID.

ID of Company that this Registration Request was created for.
Supplied by params "company_id" or if new "company_name" is provided resulting ID of created Middesk Company. This ID can be used in future Registration Requests in order to add to the same child company.
invite_linkLink sent to Employer to complete Registration Request.

Upon successful Registration Request create call (201) Middesk will send the provided employer (email) this link to complete requested registrations.

Note: This Link will expire 7 days after creation.
created_atISO 8601 UTC Timestamp when Registration Request was created by partner.