persons_update
Update a person's information in Pipedrive by providing the person ID and any fields to change, such as name, email, phone, organization, visibility, or marketing consent.
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"}]
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).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Person ID to update | |
| name | No | Full name of the person | |
| owner_id | No | ID of the user who will own this person | |
| org_id | No | ID of the organization this person belongs to | |
| 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"}] | |
| visible_to | No | Visibility: 1 (owner only), 3 (entire company), 5 (owner's followers), 7 (visibility group) | |
| marketing_status | No | Marketing consent status |