Create a registration request

curl -X POST https://api.middesk.com/v1/partner/registration_requests \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "state": "CO",
  "email": "example-employer@email.com",
  "company_name": "Company Name",
  "external_id": "external-123"
}'

{
  "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

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

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 enumsOptional

Tax registration types to request. When omitted, defaults to the types available in the requested state.

Allowed values:

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 nullOptional

submitted_atstring or nullOptional

tax_registrationmap from strings to any or nullOptional

Tax registration details

Errors

400

Create Registration Request Request Bad Request Error