Create Company
affinity_create_companyCreate a new company in Affinity CRM by providing a name and optional domain. Returns the company ID for use with other tools.
Instructions
Create a new company (organization) in Affinity.
This is a V1 API endpoint - creation is NOT available in V2.
Required fields:
name: Company name
Optional fields:
domain: Primary domain (e.g., "acme.com")
domains: Additional domains
Important:
Created companies are always custom (global=false)
Global companies from Affinity's shared database cannot be created this way
Use affinity_search_companies first to check if company exists
Created company can be retrieved via V2 affinity_get_company using returned ID
Returns (JSON): { "id": number, // Use this ID with other tools "name": string, "domain": string | null, "domains": string[], "global": false // Always false for created companies }
Example workflow:
Search: affinity_search_companies with term="acme.com"
If not found: affinity_create_company with name, domain
Get full details: affinity_get_company with the returned ID
Add note: affinity_add_note with the returned company ID
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Company name (required) | |
| domain | No | Primary domain (e.g., "acme.com") | |
| domains | No | Additional domains | |
| responseFormat | No | Output format: "json" or "markdown". Default: "json" |