Create a new company
POST/v2/companies
Creates a new company with comprehensive business information including organizational details, contact information, and hierarchical relationships.
Key Features:
- Complete business entity management with tax and legal information
- Hierarchical company structures with parent-child relationships
- Multiple address support for different business locations
- Flexible attribute system for industry-specific data
- Source system integration for external platform synchronization
Business Rules:
- Company names must be unique within the organizational hierarchy
- Tax numbers and chamber of commerce numbers are validated for format
- Email addresses must be valid and unique across the system
- Parent company relationships must reference existing companies
- Source information is required for external system integration
Organizational Features:
- Support for complex company hierarchies and subsidiaries
- Department and office management within companies
- Budget and authorization configuration
- Product and order list inheritance settings
Request
Responses
- 201
- 400
- 401
- 403
- 409
- 500
Entity created successfully with all provided information
Invalid request data or validation errors
Authentication required - provide valid OAuth2 token
Insufficient permissions - requires companies:write scope
Entity already exists with the provided identifiers
Internal server error occurred during company creation