Create a company
Creates a new company (company group). `additionalData` is validated against the additional company fields configured on your company.
bearerAuthAuthorizationBearer <token>API key sent as Authorization: Bearer <API_KEY>.
application/json- body
businessName*stringLegal name of the company. Always required on creation.
1 <= lengthdisplayName?stringCommercial name of the company. Required on creation unless the company disables mandatory fields or hides the field.
description?stringFree text description.
origin?stringOrigin of the company. Defaults to API Pública.
taxCode?stringTax identification (RUT / CUIT / NIT depending on the country). Must be unique inside your company. Required on creation unless the company disables mandatory fields or hides the field.
direction?Physical address of the company.
sectors?booleanEnables sectors for this company.
status?stringDefaults to active.
"active""inactive"additionalData?Values for the additional company fields configured on the company. Every key must match the code of an active additional company field, otherwise the request is rejected. Values are validated against the type of the field: string, number, date (ISO 8601), select (one of the configured options), multiselect (array of configured options), phonenumbers (array of valid phone numbers), selectcontact / selectcompany (id of a contact / company of your company) and multiplecontact / multiplecompany (array of those ids). Fields marked as required must be sent on creation, and fields marked as unique cannot repeat a value already used by another company.
createdBy?stringOwner of the company. Accepts the _id, email or company_id of an active user of your account. When sent, the user is also the only one able to see the company if your account restricts company visibility.
Company created successfully
application/jsoncurl -X POST 'https://api.getventia.com/api/v1.0/company-groups' \ -H 'Content-Type: application/json' \ -d '{ "businessName": "Ventia S.A.", "displayName": "Ventia", "taxCode": "218765430017", "description": "CRM provider", "origin": "API Pública", "createdBy": "user@company.com", "additionalData": { "industry": "Software", "employees": 120 }}'{ "_id": "67bca48d5fc32659c854f83c", "displayName": "Ventia", "businessName": "Ventia S.A.", "description": "CRM provider", "origin": "API Pública", "taxCode": "218765430017", "direction": { "location": true, "route": "Av. Italia", "street_number": "6201", "locality": "Montevideo", "country": "Uruguay", "formatted_address": "Av. Italia 6201, Montevideo, Uruguay", "place_id": "ChIJXXXXXXXXXXXXXXXXXXXX", "geoLocation": { "type": "Point", "coordinates": [ -56.1645, -34.8836 ] } }, "sectors": false, "status": "active", "additionalData": { "industry": "Software", "employees": 120 }, "company": "5f2b1c8e9f1b4a0017a1b2c3", "createdBy": "61a5f9d6c4e2b30017c9d123", "createdAt": "2026-02-24T18:21:01.000Z", "updatedAt": "2026-02-24T18:21:01.000Z"}