List updates about a person
GET {{baseUrl}}/persons/:id/flow?start=0&limit=<integer>&all_changes=<string>&items=<string>
Lists updates about a person.
If a company uses the Campaigns product, then this endpoint's response will also include updates for the marketing_status field.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
start | number | Pagination start | |
limit | string | Items shown per page | |
all_changes | string | Whether to show custom field updates or not. 1 = Include custom field changes. If omitted returns changes without custom field updates. | |
items | string | A comma-separated string for filtering out item specific updates. (Possible values - call, activity, plannedActivity, change, note, deal, file, dealChange, personChange, organizationChange, follower, dealFollower, personFollower, organizationFollower, participant, comment, mailMessage, mailMessageWithAttachment, invoice, document, marketing_campaign_stat, marketing_status_change). |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"success":true,"data":[{"object":"personChange","timestamp":"2020-08-03 11:25:21","data":{"id":11158,"item_id":3512,"user_id":8877,"field_key":"org_id","old_value":null,"new_value":1482,"is_bulk_update_flag":null,"log_time":"2020-08-03 11:25:21","change_source":"app","change_source_user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML like Gecko) Chrome/84.0.4147.89 Safari/537.36","additional_data":{"new_value_formatted":"Umbrella Corp."}}},{"object":"activity","timestamp":"2020-08-07 08:15:00","data":{"id":8,"company_id":22122,"user_id":1234,"done":false,"type":"deadline","reference_type":"scheduler-service","reference_id":7,"conference_meeting_client":"871b8bc88d3a1202","conference_meeting_url":"https://pipedrive.zoom.us/link","conference_meeting_id":"17058746701","due_date":"2020-06-09","due_time":"10:00","duration":"01:00","busy_flag":true,"add_time":"2020-06-08 12:37:56","marked_as_done_time":"2020-08-08 08:08:38","last_notification_time":"2020-08-08 12:37:56","last_notification_user_id":7655,"notification_language_id":1,"subject":"Deadline","public_description":"This is a description","calendar_sync_include_context":"","location":"Mustamäe tee 3, Tallinn, Estonia","org_id":5,"person_id":1101,"deal_id":300,"lead_id":"46c3b0e1-db35-59ca-1828-4817378dff71","project_id":null,"active_flag":true,"update_time":"2020-08-08 12:37:56","update_user_id":5596,"gcal_event_id":"","google_calendar_id":"","google_calendar_etag":"","source_timezone":"","rec_rule":"RRULE:FREQ=WEEKLY;BYDAY=WE","rec_rule_extension":"","rec_master_activity_id":1,"series":[],"note":"A note for the activity","created_by_user_id":1234,"location_subpremise":"","location_street_number":"3","location_route":"Mustamäe tee","location_sublocality":"Kristiine","location_locality":"Tallinn","location_admin_area_level_1":"Harju maakond","location_admin_area_level_2":"","location_country":"Estonia","location_postal_code":"10616","location_formatted_address":"Mustamäe tee 3, 10616 Tallinn, Estonia","attendees":[{"email_address":"attendee@pipedrivemail.com","is_organizer":0,"name":"Attendee","person_id":25312,"status":"noreply","user_id":null}],"participants":[{"person_id":17985,"primary_flag":false},{"person_id":1101,"primary_flag":true}],"org_name":"Organization","person_name":"Person","deal_title":"Deal","owner_name":"Creator","person_dropbox_bcc":"company@pipedrivemail.com","deal_dropbox_bcc":"company+deal300@pipedrivemail.com","assigned_to_user_id":1235,"file":{"id":"376892,","clean_name":"Audio 10:55:07.m4a","url":"https://pipedrive-files.s3-eu-west-1.amazonaws.com/Audio-recording.m4a"}}}],"additional_data":{"pagination":{"start":0,"limit":100,"more_items_in_collection":true}},"related_objects":{"allOf":[{"user":{"123":{"id":123,"name":"Jane Doe","email":"jane@pipedrive.com","has_pic":1,"pic_hash":"2611ace8ac6a3afe2f69ed56f9e08c6b","active_flag":true}}},{"person":{"1101":{"active_flag":true,"id":1101,"name":"Person","email":[{"label":"work","value":"person@pipedrive.com","primary":true}],"phone":[{"label":"work","value":"3421787767","primary":true}],"owner_id":8877}}},{"organization":{"1":{"id":1,"name":"Org Name","people_count":1,"owner_id":123,"address":"Mustamäe tee 3a, 10615 Tallinn","active_flag":true,"cc_email":"org@pipedrivemail.com"}}}]}}