---
title: "Create Hosted Signup Session"
method: POST
path: "/accounts/signup/sessions"
---

# Create Hosted Signup Session

`POST /accounts/signup/sessions`

Provides a URL for directing a user through the hosted signup experience. Upon successful completion the user will be redirected to the callback_url. The returned legal entity id will not be active until the user has completed their signup. If a subsequent signup needs to be generated for a user the returned legal_entity_id from the first should be included in the request.

## Query parameters

- `verbose` boolean

## Headers

- `authorization` string, nullable

## Request body

- AppApiPlatformAuthHostedSignupRequest
  - `business_name` string, required
  - `user_email` string, required
  - `callback_url` string, required
  - `legal_entity_id` string, nullable
  - `business_information` AppApiPlatformAuthHostedSignupRequestBusinessInformation
    - `incorporation_region` string, nullable
    - `entity_type` 'unset' | 'c_corp' | 'p_corp' | 'llc' | 'llp' | 'lp' | 'gp'
    - `tax_classification` 'unset' | 'corp' | 's_corp' | 'partnership' | 'disregarded' | 'tax_exempt' — The IRS tax classification for an entity. In some circumstances, a company can elect to be treated different from the entity type for tax purposes. For example, an LLC can elect to be taxed as a corporation. - Corp: taxed as a corporation, the default for C Corps - S Corp: election using IRS Form 2553 - Partnership: taxed as a partnership, the default for LPs - Disregarded: taxes pass through to the members, default for LLCs - Tax Exempt: an entity that is recognized by the IRS as being exempt from paying federal income taxes on its earnings
    - `llc_managed_type` 'member_managed' | 'manager_managed'
    - `business_name` string, nullable
    - `business_purpose` string, nullable
    - `ein` string, nullable
    - `incorporation_date` string, date, nullable
    - `naics_code` string, nullable
    - `accounting_method` 'accrual' | 'cash'
    - `accounting_period` 'fiscal' | 'calendar'
    - `accounting_year_end` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12
    - `futa_liability_year` string, nullable
  - `external_company_id` string, nullable

## Response `200`

Successful Response

- AppApiPlatformAuthHostedSignupResponse
  - `signup_url` string, required — This is a deprecated field, please use url
  - `url` string, required — This is a session scoped URL which allows users to completed the signup process.
  - `created_at` string, required
  - `expires_at` string, required
  - `legal_entity_id` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mosey/apis/mosey-api.md) · [All operations](https://skmtc.net/mosey/apis/mosey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mosey/mosey-api/versions/2121b0e65643/schema)