Create a registration request

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

1	curl -X POST https://api.middesk.com/v1/partner/registration_requests \
2	-H "Content-Type: application/json" \
3	-u "<username>:<password>" \
4	-d '{
5	"state": "CO",
6	"email": "example-employer@email.com",
7	"company_name": "Company Name",
8	"external_id": "external-123"
9	}'

1	{
2	"object": "registration_request",
3	"id": "190ddf8b-cced-4372-8a58-bed85835bb68",
4	"state": "CO",
5	"status": "pending",
6	"tax_registration_types": [
7	"state_unemployment_insurance",
8	"state_tax_withholdings"
9	],
10	"company_id": "ad2eb516-13da-4750-9e64-7fdb41ced55b",
11	"created_at": "2025-12-26T21:37:00Z",
12	"agencies": [
13	{
14	"key": "value"
15	}
16	],
17	"items": [
18	{
19	"key": "value"
20	}
21	],
22	"invite_link": "https://agent.middesk.com/invitations?guest_token=6c4ad0748b5e416c9dd44109c96d46ae",
23	"external_id": "external-123"
24	}

Authentication

Request

Response

Errors