Create a client company
Creates a client user and a company shell attributed to you. The client receives no messages from Clemta. Pass Idempotency-Key to make retries safe.
Authorizations
Your API key, e.g. Authorization: Bearer clmt_test_. Live keys use the clmt_live_ prefix.
Headers
Date-based API version to run this request against.
"2026-08-13"
The account (the incorporator) to create the company under, when it already exists. Omit it and pass account in the body to create one at the same time. Set one or the other, never both.
^acct_[0-9A-Za-z]{22}$"acct_0346sFPEvSkJvY8vt14NNw"
Query Parameters
Relations to embed. Expandable: account, requirements (the open requirements behind open_requirements), service_orders (every order on the company, auto-attached mandatory products included).
account, requirements, service_orders Body
Legal name of the company to form, without the ending. IRS naming rules apply: letters, numbers, spaces, hyphen (-) and ampersand (&) only, and the name must not start with "The". The ending ("LLC", "Inc.") is the separate ending field. A name already registered with us in the same state is refused up front (invalid_request). The state registry remains the final authority - a conflict it finds later arrives as a name_change requirement.
1 - 255^[A-Za-z0-9 &-]+$US state of formation, as a two-letter code.
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, DC "DE"
Entity type to form.
llc, c_corp "llc"
Your own identifier for this company. Must be unique across your companies. Reusing one is rejected. Use Idempotency-Key to retry safely.
1 - 255How the legal name renders around the ending: plain ("Acme LLC") or comma ("Acme, LLC"). The rendered result is the read-only legal_name on the company.
plain, comma Whether the owners are kept off the public filing. private is available only in the states that offer it - DE, NV, WY, NM - and is rejected elsewhere.
public, private Did the company exist before you brought it here? false (the default): Clemta forms it, and the formation is billed. true: an already-formed company you are bringing in to offer services on - no formation is billed. Products marked required_for the matching set (formation or existing) attach automatically.
The company name suffix, as an API token. The rendered legal text is llc -> "LLC", l_l_c -> "L.L.C.", limited_liability_company -> "Limited Liability Company", inc -> "Inc.", incorporated -> "Incorporated", co -> "Co.", corp -> "Corp", corporation -> "Corporation" (see legal_name on the company). Must match the entity type - the first three are LLC endings, the rest C-Corp endings.
llc, l_l_c, limited_liability_company, inc, incorporated, co, corp, corporation The company's primary industry, from the platform's standard industry catalog, as API tokens. other requires custom_industry and industry_description.
accounting, advertising, agriculture, art, theater, beauty_and_cosmetic_services, biotech, business_management, cleaning_services, construction, consulting, design, e_commerce, education, entertainment, financial_services, fitness, food, hardware, health_services, insurance, investment, legal, logistics, marketing, marketplace, real_estate, recruiting, research, retail_wholesale, shipping_warehousing, support_services, software, technology, transportation, other The company's EIN, for a pre_existing company that already holds one. Stored formatted 12-3456789. company.ein.assigned does not fire for a value supplied here. Rejected when Clemta forms the company - the EIN is issued during formation and appears on the company once assigned (company.ein.assigned).
12^[0-9]{2}-?[0-9]{7}$The company's legal address. Required for a pre_existing company - an existing company has one by definition. Rejected when Clemta forms the company - Clemta records the address during formation and it appears on the company then.
States the company is registered in beside its formation state, for a pre_existing company. Each names a different state than the formation state. Rejected when Clemta forms the company.
10A free-text description of the business. Required when industry is other, rejected otherwise.
500The short name of the custom industry. Required when industry is other, rejected otherwise.
120IANA time zone for the company (e.g. America/Chicago). Defaults to the formation state's primary zone.
64Total authorized shares. Required for a c_corp. Not accepted for an llc, which is issued a fixed 100 membership units.
x >= 1Par value per share, in dollars. Required for a c_corp. Not accepted for an llc.
x >= 0Account details to create the incorporator alongside this company, when you have not created one yet. Omit it and set the Clemta-Account header to create the company under an account that already exists. Pass one or the other, never both. Reusing an account external_id returns the account already on file instead of creating a duplicate.
The company's owners, as structured data. Optional at create - owners can also be collected later through the embedded form. Identity documents are never sent here. Upload them through the Files API and reference them by passport. When present, exactly one owner must be the main incorporator.
25The management roster - everyone who holds a position, each with their roles. A director is an officer holding role director. There is no separate directors list. Optional: when omitted, a shareholder's relationship.director flag seats directors. When given, this list is the roster. An officer whose email matches a shareholder's is seated as that owner.
50LLC only - whether the company is member-managed or manager-managed.
member_managed, manager_managed Products to order on the company at creation, by key - the same keys GET /products lists. Each is attached as a service order and billed to you at your wholesale price, alongside the formation. Formation itself is implied by creating the company and need not be listed here.
25^[a-z][a-z0-9_]{1,48}$Variant choices for the services attached at creation, keyed by product key - the listed ones, the mandatory ones, the formation itself ({"formation_llc": {"turnaround": "expedited"}} is how expedited filing is chosen, and registration is the only moment it can be), and the formation bundle's included services. A key naming a product that is not being attached is refused.
Your own key-value pairs, stored and returned verbatim.
Response
The created company.
Entity name. Identifies this object when it arrives without its URL - nested under an expand[], inside an event payload, or in a webhook.
company Identifier of the company.
^cmp_[0-9A-Za-z]{22}$"cmp_0346sFPEvSkJvY8vt14NNw"
The account (the incorporator) this company was created under. Expand account to embed the full object.
^acct_[0-9A-Za-z]{22}$"acct_0346sFPEvSkJvY8vt14NNw"
False for a company created with a test key. A test company is a sandbox simulation - it never reaches fulfillment or billing.
Legal name of the company.
US state of formation, as a two-letter code.
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, DC "DE"
Entity type being formed.
llc, c_corp "llc"
Lifecycle status. A company starts in requires_information while it waits for its owners' identity documents. It moves to in_progress once every required document is present and it is submitted for formation, and to active once fulfilled.
requires_information, in_progress, active, cancelled, dissolved Whether the company's owners have submitted the identity documents needed to file. verified_at records when. State filings wait for it.
pending, verified When the company was created.
When the company was last modified. Also written to the Last-Modified response header on a single-company fetch, so a conditional If-Modified-Since request can be answered 304 Not Modified.
Your own identifier for this company, unique across your companies.
The full account this company was created under. Present only when requested with expand[]=account.
Free-text description of the business, present when industry is other.
Short name of the custom industry, present when industry is other.
The company's IANA time zone.
How the legal name renders around the ending.
plain, comma The rendered legal name - name, the name_style separator, and the ending ("Acme, LLC").
Whether the owners are kept off the public filing. Choosable only in DE, NV, WY, NM.
public, private True when the company already existed before it was brought to Clemta. False when Clemta forms it.
The federal tax id, once the IRS has issued it. Fires company.ein.assigned when it lands.
When every owner's identity document was in and the company was ready for formation. company.verified announces this moment, and it does not change afterward.
When the company was dissolved. Terminal: the company's status is dissolved from that moment, every recurring service stopped renewing, open requirements were closed, and nothing further can be ordered. company.dissolved announces this moment, and it does not change afterward.
When the company was marked incorporated in Clemta - the moment company.incorporated fires. It can differ from incorporation_date, the legal formation date the state assigned.
When the EIN was assigned. company.ein.assigned announces this moment, and it does not change afterward.
The fine-grained formation step under status - where formation stands right now. Changes fire company.status.changed. Reaching incorporated also fires company.incorporated.
preparing_documents, documents_generated, signature_requested, submitted_to_state, name_conflict, incorporated, closed The legal formation date the state assigned, recorded from the formation document (for a pre_existing company, the one uploaded through its requirement). It can differ from incorporated_at, which is when Clemta marked the company incorporated. Never an input. company.updated announces changes.
The company's legal address, maintained by Clemta.
States the company is registered in beside its formation state.
Rights the company holds, as counts remaining. An order for an entitlement product adds one. A tax filing consumes one when it is submitted. Some may be granted directly. company.entitlements.changed announces every move.
How many requirements currently stand open on this company - "is anything waiting on you" in one number, without touching status. Derived at read time on API responses. Webhook data.object snapshots omit it.
Every service order on the company, newest first, embedded when the request carries expand[]=service_orders - including the mandatory products a create attached automatically. The same rows GET /companies/{id}/service-orders lists.
The open requirements themselves, embedded when the request carries expand[]=requirements - the list behind open_requirements. Resolved history stays on GET /companies/{id}/requirements.
The company's owners. Collect a missing identity document by attaching an uploaded file (passport) or by creating a verification session for the owner.
The management roster - everyone who holds a position. A director is an officer holding the director role. There is no separate directors list. Includes officers who are not owners. Set at company creation, and kept current as the roster changes.
LLC only - whether the company is member-managed or manager-managed.
member_managed, manager_managed Whether the officer roster is final. When true with an empty officers, the company has no officers by design, not a roster still being collected.
Your own key-value pairs, stored and returned verbatim. Clemta never reads them.