Create a registration request

import requests
url = "https://api.middesk.com/v1/partner/registration_requests"
payload = {
    "state": "CO",
    "email": "example-employer@email.com",
    "company_name": "Company Name",
    "external_id": "external-123"
}
headers = {
    "Authorization": "Basic <username>:<password>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "object": "registration_request",
  "id": "190ddf8b-cced-4372-8a58-bed85835bb68",
  "state": "CO",
  "status": "pending",
  "tax_registration_types": [
    "state_unemployment_insurance",
    "state_tax_withholdings"
  ],
  "company_id": "ad2eb516-13da-4750-9e64-7fdb41ced55b",
  "created_at": "2025-12-26T21:37:00Z",
  "agencies": [
    {
      "key": "value"
    }
  ],
  "items": [
    {
      "key": "value"
    }
  ],
  "invite_link": "https://agent.middesk.com/invitations?guest_token=6c4ad0748b5e416c9dd44109c96d46ae",
  "external_id": "external-123"
}

Authentication

AuthorizationBasic

Basic authentication of the form Basic <username:password>.

Request

This endpoint expects an object.

stateenumRequired

US state abbreviation (required)

emailstringRequiredformat: "email"

User email (required)

company_idstringOptionalformat: "uuid"

Existing company ID

company_namestringOptional

Company name for new company

external_idstringOptional

External company identifier

tax_registration_typeslist of stringsOptional

Types of tax registrations (e.g., sales_tax, payroll_tax)

jurisdictionslist of stringsOptional

Tax jurisdictions

redirect_uristringOptionalformat: "uri"

Success redirect URL

redirect_back_uristringOptionalformat: "uri"

Back redirect URL

Response

registration request created

objectstring

idstringformat: "uuid"

stateenum

US state abbreviation

statusstring

Request status

tax_registration_typeslist of strings or null

Types of tax registrations requested

company_idstringformat: "uuid"

created_atstring

agencieslist of maps from strings to any

Tax agency registrations

itemslist of maps from strings to any

Registration items

invite_linkstringformat: "uri"

external_idstring or null

submitted_atstring or null

tax_registrationmap from strings to any or null

Tax registration details

Authentication

Request

Response

Errors