persons_add_picture
Upload an image to set or update a person's profile picture in Pipedrive. Supports optional cropping for precise image adjustment.
Instructions
Add or update a person's profile picture.
Uploads an image file to set as the person's profile picture. The image will be:
Displayed in person records
Shown in lists and search results
Visible to users with access to the person
Used across the Pipedrive interface
Image requirements:
Format: JPEG, PNG, GIF
Recommended size: 512x512 pixels
Maximum file size: Typically 5-10 MB (check Pipedrive limits)
Cropping parameters (optional):
Use crop_x, crop_y to set the top-left corner of the crop area
Use crop_width, crop_height to define the crop dimensions
All crop values are in pixels
If not provided, the full image is used
Workflow:
Read the image file as a Buffer
Provide the filename (with extension)
Optionally specify crop parameters
The tool uploads and sets the picture
Use cases:
Adding profile photos for contacts
Updating person images
Visual identification in CRM
Personalization and branding
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Person ID | |
| file | Yes | Base64-encoded image file or file buffer | |
| filename | Yes | Name of the image file (e.g., "photo.jpg") | |
| crop_x | No | X coordinate for cropping (pixels) | |
| crop_y | No | Y coordinate for cropping (pixels) | |
| crop_width | No | Width of crop area (pixels) | |
| crop_height | No | Height of crop area (pixels) |