persons_update
Update a person's record in Pipedrive CRM with new name, email, phone, job title, or custom fields using the person ID.
Instructions
Update an existing person's information.
Required fields:
id: Person ID to update
Optional fields (only provide fields you want to change):
name: Full name
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)
Note: When updating email/phone arrays, provide the complete array (it replaces the existing one).
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 |
|---|---|---|---|
| id | Yes | Person ID to update | |
| name | No | Full name of the person | |
| No | Email addresses array (replaces existing). Example: [{"value": "john@company.com", "primary": true, "label": "work"}] | ||
| phone | No | Phone numbers array (replaces existing). Example: [{"value": "+1234567890", "primary": true, "label": "mobile"}] | |
| org_id | No | ID of the organization this person belongs to | |
| 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 |