persons_update
Update an existing person's information in Pipedrive. Provide the person ID and any fields to modify, including name, contact details, organization, and custom fields.
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 |