Skip to main content
POST
/
corporations
curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/corporations' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "legal_name": "Acme Corporation Inc.",
    "jurisdiction": "US",
    "email_alias": "acme"
  }'

{
  "message": "Corporation created successfully.",
  "data": {
    "id": "corp_123abc",
    "legal_name": "Acme Corporation Inc.",
    "created_at": 1704067200,
    "jurisdiction": "US",
    "email_alias": "acme@filings.commenda.io"
  }
}
Creates a new corporation entity in your organization. A corporation represents a distinct legal entity or business.
​
legal_name
string
required
Legal name of the entity, including the type suffix (e.g., “Inc.”, “LLC”).
​
jurisdiction
string
required
The ISO 3166 2-alpha country code where the business entity is registered.
curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/corporations' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "legal_name": "Acme Corporation Inc.",
    "jurisdiction": "US",
    "email_alias": "acme"
  }'

{
  "message": "Corporation created successfully.",
  "data": {
    "id": "corp_123abc",
    "legal_name": "Acme Corporation Inc.",
    "created_at": 1704067200,
    "jurisdiction": "US",
    "email_alias": "acme@filings.commenda.io"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request body for creating a new corporation.

​
legal_name
string
required

The legal name of the corporation.

Example:

"Acme Corporation"

Response

Sales tax registration response

​
data
object

A corporation registered with Commenda.

​
message
string
Example:

"Successfully created corporation."