Skip to content

by Startups.Studio

OverviewCompany

Company.incorporate

POST /{namespace}/companies/incorporate

Incorporate forms a Company in a chosen jurisdiction, with its founders, shares and registered agent on record.

Noun: Company
Mode: do
Event: Company.incorporated

You, to your agent

Incorporate the company “PatentPad Inc.

curl -X POST https://api.sb/patentpad.com/companies/incorporate \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"legalName":"PatentPad Inc.","jurisdiction":"US-DE"}'

import { $ } from 'startup-builder'

const company = await $.Company.incorporate({ legalName: 'PatentPad Inc.', jurisdiction: 'US-DE' })

npx startup-builder do Company.incorporate --json '{"legalName":"PatentPad Inc.","jurisdiction":"US-DE"}'

{
  "name": "do",
  "arguments": {
    "code": "return await $.Company.incorporate({ legalName: 'PatentPad Inc.', jurisdiction: 'US-DE' })"
  }
}

Inputs

Input	Type	Required	Description
`legalName`	`string`	required	The registered name.
`jurisdiction`	`string`	required	Where the Company forms.

Outputs

Output	Type	Required	Description
`company`	Company	required	The new Company.

Effects

Emits Company.incorporated.
Performed by the Founder.
One-way (money): it waits out its delay window, and runs in the send and do modes.
Runs through Company formation, which files the certificate and appoints the first directors.
Waits for the Founder, as an officer, to sign the formation documents: the legal floor.
Opens the Company’s cap table.

Refuses when

Check	Error	Fix	Then call
The input does not match the schema of the operation.	`invalid-input`	Read the schema of the operation, then send every required field with the right type.	Company.incorporate
The key is valid, but its scopes do not allow this operation.	`forbidden`	Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them.	Company.incorporate
The record is not in a state that allows this Verb, so the call is refused.	`refused`	Read the record, run the Verb that moves it to an allowed state, then retry.	Company.incorporate

When it waits

Gate	Default
Decision class	High: one-way, broad (money)
Delay window	1 business day, in which a watcher can pause, redirect or cancel it; then it runs.
Limit	The spend Limit of the Permission or Mandate it runs under.
Over the Limit	It waits `pending` for an Approval from the Founder. Approved, it runs; refused, it ends `refused` with `limit-exceeded`; unanswered by its deadline, it ends `canceled`.