Authorization
apiKey In: query
Request Body
application/json
Legal name of the company. Always required on creation.
1 <= lengthCommercial name of the company. Required on creation unless the company disables mandatory fields or hides the field.
Free text description.
Origin of the company. Defaults to API Pública.
Tax 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.
Physical address of the company.
Enables sectors for this company.
Defaults to active.
"active" | "inactive"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.
Owner 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.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -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"
}{
"success": false,
"error": "Invalid company body",
"details": "businessName: Required"
}{
"success": false,
"error": "Invalid API Key"
}{
"success": false,
"error": "createdBy user doesn't exist or is not an active user"
}{
"success": false,
"error": "Internal server error"
}