> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.middesk.com/reference/registration-request-param/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.middesk.com/_mcp/server.

# RegistrationRequestParam object

> Lists the contents of a registration request parameter object.

This page describes the `registration_request_param` object, which contains the parameters used to create a new registration request.

**`Example JSON request`**

```json title="Example JSON request"
{
  "state": "CA",
  "email": "jane.smith@example.com",
  "company_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "company_name": "Acme Corporation",
  "external_id": "ext-12345",
  "tax_registration_types": ["sales_tax", "payroll_tax"],
  "jurisdictions": ["state", "local"],
  "redirect_uri": "https://example.com/registration/success",
  "redirect_back_uri": "https://example.com/registration/back"
}
```

## RegistrationRequestParam attributes

| Attribute                | Type           | Description                                                                      |
| ------------------------ | -------------- | -------------------------------------------------------------------------------- |
| `state`                  | string         | US state abbreviation where registration is being requested. Required.           |
| `email`                  | string (email) | Email address of the user completing the registration. Required.                 |
| `company_id`             | string (uuid)  | ID of an existing company to register. Use this or `company_name`.               |
| `company_name`           | string         | Name of a new company to create and register. Use this or `company_id`.          |
| `external_id`            | string         | External identifier for the company in your system.                              |
| `tax_registration_types` | array\[string] | Types of tax registrations to request (for example, `sales_tax`, `payroll_tax`). |
| `jurisdictions`          | array\[string] | Tax jurisdictions to register in.                                                |
| `redirect_uri`           | string (uri)   | URL to redirect to after successful registration completion.                     |
| `redirect_back_uri`      | string (uri)   | URL to redirect to if user navigates back.                                       |

## State values

The `state` attribute accepts standard two-letter US state abbreviations:

`AL`, `AK`, `AZ`, `AR`, `CA`, `CO`, `CT`, `DE`, `FL`, `GA`, `HI`, `ID`, `IL`, `IN`, `IA`, `KS`, `KY`, `LA`, `ME`, `MD`, `MA`, `MI`, `MN`, `MS`, `MO`, `MT`, `NE`, `NV`, `NH`, `NJ`, `NM`, `NY`, `NC`, `ND`, `OH`, `OK`, `OR`, `PA`, `RI`, `SC`, `SD`, `TN`, `TX`, `UT`, `VT`, `VA`, `WA`, `WV`, `WI`, `WY`

## Tax registration types

Common values for `tax_registration_types`:

| Type          | Description                               |
| ------------- | ----------------------------------------- |
| `sales_tax`   | Sales and use tax registration.           |
| `payroll_tax` | Payroll and withholding tax registration. |

> **Get a demo**
>
> Contact your account manager or [contact sales](https://www.middesk.com/contact-sales) to inquire about access.

> Lists the contents of a registration request parameter object.