Sign in
companies

Create One company

post/companies

Request

  • Base URL: https://twenty.mardu.systems/rest
  • URL: https://twenty.mardu.systems/rest/companies
  • Auth: HTTP bearer

Query parameters

depth0 | 1

Determines the level of nested related objects to include in the response. - 0: Primary object only - 1: Primary object + direct relations

upsertboolean

If true, creates the object or updates it if it already exists.

Request body

namestring

The company name

employeesinteger

Number of employees in the company

idealCustomerProfileboolean

Ideal Customer Profile: Indicates whether the company is the most suitable and valuable customer for you

positionnumber

Company record position

accountOwnerIdstring uuid

Example request

{
  "name": "Company name",
  "domainName": {
    "primaryLinkLabel": "",
    "primaryLinkUrl": "https://impractical-stir-fry.biz",
    "secondaryLinks": []
  },
  "linkedinLink": {
    "primaryLinkLabel": "",
    "primaryLinkUrl": "https://agreeable-rubric.name",
    "secondaryLinks": []
  },
  "xLink": {
    "primaryLinkLabel": "",
    "primaryLinkUrl": "https://graceful-duffel.com/",
    "secondaryLinks": []
  },
  "annualRecurringRevenue": {
    "amountMicros": "153000000",
    "currencyCode": "EUR"
  }
}

Response

Successful operation

Changes

No recorded changes to this operation across all 1 revision of this API.