persons_create
Create a person record in Pipedrive by providing a name and optional fields for contact information, organization, visibility, and custom fields.
Instructions
Create a new person in Pipedrive.
Required fields:
name: Full name of the person
Optional fields:
owner_id: User who will own this person
org_id: Organization this person belongs to
email: Array of email addresses with format: [{"value": "john@company.com", "primary": true, "label": "work"}]
phone: Array of phone numbers with format: [{"value": "+1234567890", "primary": true, "label": "mobile"}]
job_title: Job title / function of the person (max 255 characters)
visible_to: Visibility level (1=owner only, 3=entire company, 5=owner's followers, 7=visibility group)
marketing_status: Marketing consent status (no_consent, unsubscribed, subscribed, archived)
add_time: Optional creation time in YYYY-MM-DD HH:MM:SS format
Example email/phone arrays: { "email": [ {"value": "john@company.com", "primary": true, "label": "work"}, {"value": "john@personal.com", "primary": false, "label": "home"} ], "phone": [ {"value": "+1234567890", "primary": true, "label": "mobile"} ] }
Custom fields:
Pass display names: { "custom_fields": { "Region": "EU", "Tier": "Gold" } }
Or hash keys directly: { "custom_fields": { "abc123...": "raw value" } }
For enum/set fields, pass option labels (not ids).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Full name of the person (required) | |
| No | Email addresses array. Example: [{"value": "john@company.com", "primary": true, "label": "work"}] | ||
| phone | No | Phone numbers array. Example: [{"value": "+1234567890", "primary": true, "label": "mobile"}] | |
| org_id | No | ID of the organization this person belongs to | |
| add_time | No | Creation time in YYYY-MM-DD HH:MM:SS format | |
| owner_id | No | ID of the user who will own this person | |
| job_title | No | Job title / function of the person (max 255 characters) | |
| visible_to | No | Visibility: 1 (owner only), 3 (entire company), 5 (owner's followers), 7 (visibility group) | |
| custom_fields | No | Custom field values keyed by display name or hash. | |
| marketing_status | No | Marketing consent status |