PIpipedrive
Persons

List updates about a person

Changed on

Lists updates about a person.<br>If a company uses the Campaigns product, then this endpoint's response will also include updates for the marketing_status field.

get/persons/{id}/flow

Request

  • Base URL
    https://api.pipedrive.com/v1
  • Auth
    • API key in header x-api-token
    • or OAuth 2
      Authorization code: https://oauth.pipedrive.com/oauth/authorize
      Token URL: https://oauth.pipedrive.com/oauth/token scopes: recents:read

Path parameters

idinteger required

The unique ID of the person

Query parameters

startinteger

Pagination start

limitinteger

Items shown per page

all_changesstring

Whether to show custom field updates or not. 1 = Include custom field changes. If omitted returns changes without custom field updates.

itemsstring[]

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).

Response

Get the person updates

successboolean

If the response is successful or not

Changes

  • 49ebb01fee1cRevision changes
    • breaking

      for the query request parameter items, the type changed from string to array

  • 24d2d929aac3Revision changes
    • breaking

      the response property ///// became nullable for the status

    • breaking

      the response property ///// became nullable for the status