---
title: "Embedded Signup"
method: POST
path: "/accounts/signup"
---

# Embedded Signup

`POST /accounts/signup`

## Query parameters

- `verbose` boolean

## Headers

- `authorization` string, nullable

## Request body

- EmbeddedSignupRequest
  - `user_email` string, required
  - `business_name` string, required
  - `entity_type` 'unset' | 'c_corp' | 'p_corp' | 'llc' | 'llp' | 'lp' | 'gp', required
  - `tax_classification` 'unset' | 'corp' | 's_corp' | 'partnership' | 'disregarded' | 'tax_exempt', required — 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
  - `incorporation_location` string, required
  - `incorporation_date` string, date, required
  - `ein` string, nullable
  - `llc_managed_type` 'member_managed' | 'manager_managed'
  - `business_purpose` string, nullable
  - `business_phone` string, nullable
  - `business_email` string, nullable
  - `business_address` Address
    - `id` string, nullable
    - `address_line_1` string, required
    - `address_line_2` string, nullable
    - `city` string, required
    - `state` string, required
    - `country` string, required
    - `postal_code` string, required
  - `mailing_address` Address
    - `id` string, nullable
    - `address_line_1` string, required
    - `address_line_2` string, nullable
    - `city` string, required
    - `state` string, required
    - `country` string, required
    - `postal_code` string, required
  - `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
  - `authorization_callback_url` string, nullable

## Response `200`

Successful Response

- EmbeddedSignupResponse
  - `legal_entity_id` string, required
  - `authorization_url` string, nullable — This is deprecated. Please see url field
  - `url` string, nullable — This is a session scoped URL that allows users to complete the signup process.

## 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/revisions/2121b0e65643/schema)