Actions15
Company → Create
AI-generatedSummary
Create a new Company entity in the IDB2B system by providing a required company name and optional additional fields such as website, description, industry ID, size ID, status ID, source ID, and owner ID.
Inputs
- Name (required) — The name of the company to create.
- Additional Fields — Optional fields to enrich the company record including Website URL, Description, Industry ID, Size ID, Status ID, Source ID, and Owner ID.
Output shape
A single JSON object representing the created Company, including all server-returned fields. If the API does not return the created entity, the response includes the initially sent data with annotation indicating missing server-generated fields.
The operation requires authentication credentials with permission to create companies. Validation ensures the Name field is a non-empty string with a max length of 255 characters. Optional additional fields are included if provided and not empty. The response may omit server-generated fields like ID and timestamps if the server returns null data upon creation.
Examples
Example 1: Create Company with minimal required data
Set Name to 'Acme Corp', leave Additional Fields empty or default.
Example 2: Create Company with several optional details
Set Name, Website URL, Description, Industry ID, Size ID, Status ID, Source ID, and Owner ID as desired to enrich the company record.