Create Person
affinity_create_personAdd a new contact to Affinity with required first and last names, and optional emails and organization associations. Returns the new person's ID.
Instructions
Create a new person (contact) in Affinity.
This is a V1 API endpoint - creation is NOT available in V2.
Required fields:
firstName: Person's first name
lastName: Person's last name
Optional fields:
emails: Array of email addresses (first becomes primary)
organizationIds: Array of organization IDs to associate
Important:
Duplicate email addresses will return a 422 error
Use affinity_search_persons first to check if person exists
Created person can be retrieved via V2 affinity_get_person using returned ID
Returns (JSON): { "id": number, // Use this ID with other tools "first_name": string, "last_name": string, "primary_email": string | null, "emails": string[], "type": 0 // 0 = external contact }
Example workflow:
Search: affinity_search_persons with term="john@example.com"
If not found: affinity_create_person with firstName, lastName, emails
Add note: affinity_add_note with the returned person ID
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| firstName | Yes | First name (required) | |
| lastName | Yes | Last name (required) | |
| emails | No | Email addresses. First email becomes primary_email. Can be empty array. | |
| organizationIds | No | Organization IDs to associate with this person | |
| responseFormat | No | Output format: "json" or "markdown". Default: "json" |