Create a new contact within a company
POST/v2/contacts
Creates a new contact entity associated with a specific company. Contacts represent individual people within organizations and include personal information, communication preferences, and role details.
Key Features:
- Company association with automatic relationship management
- Personal information management (name, contact details, preferences)
- Flexible attribute system for custom contact data
- Source system integration for external platform synchronization
- Automatic company relationship validation
Business Rules:
- Contact must be associated with an existing company
- Email addresses must be unique across the system
- At least one contact method (email, phone, or mobile) is recommended
- Company relationship must reference valid company entities
- Source information is required for external system integration
Relationship Management:
- Automatic association with primary company
- Support for multiple company relationships
- Role and responsibility tracking
- Communication preference management
- Integration with company organizational structures
Request
Responses
- 201
- 400
- 401
- 403
- 409
- 500
Contact created successfully with company association
Invalid request data or validation errors
Authentication required - provide valid OAuth2 token
Insufficient permissions - requires contacts:write scope
Contact already exists with the provided email or source identifier
Internal server error occurred during contact creation