Skip to main content
GET
/
contacts
/
v1
/
lists
/
recently_updated
/
contacts
/
recent
Get recently updated and created contacts
curl --request GET \
  --url https://api.hubapi.com/contacts/v1/lists/recently_updated/contacts/recent
{
  "contacts": [
    {
      "addedAt": 1484858431084,
      "vid": 3234574,
      "canonical-vid": 3234574,
      "merged-vids": [],
      "portal-id": 62515,
      "is-contact": true,
      "properties": {
        "firstname": {
          "value": "Jeff"
        },
        "lastmodifieddate": {
          "value": "1484858431084"
        },
        "company": {
          "value": "HubSpot"
        },
        "lastname": {
          "value": "Testing"
        }
      },
      "form-submissions": [],
      "identity-profiles": [
        {
          "vid": 3234574,
          "saved-at-timestamp": 1484026585613,
          "deleted-changed-timestamp": 0,
          "identities": [
            {
              "type": "EMAIL",
              "value": "testingapis@hubspot.com",
              "timestamp": 1484026585538
            },
            {
              "type": "LEAD_GUID",
              "value": "4b11f8af-50d9-4665-9c43-bb2fc46e3a80",
              "timestamp": 1484026585610
            }
          ]
        }
      ],
      "merge-audits": []
    },
    {
      "addedAt": 1484854580823,
      "vid": 3714024,
      "canonical-vid": 3714024,
      "merged-vids": [],
      "portal-id": 62515,
      "is-contact": true,
      "properties": {
        "firstname": {
          "value": "Updated"
        },
        "lastmodifieddate": {
          "value": "1484854580823"
        },
        "lastname": {
          "value": "Record"
        }
      },
      "form-submissions": [],
      "identity-profiles": [
        {
          "vid": 3714024,
          "saved-at-timestamp": 1484854496366,
          "deleted-changed-timestamp": 0,
          "identities": [
            {
              "type": "LEAD_GUID",
              "value": "670706c0-3f5c-485b-9bee-5d0b0c6aef97",
              "timestamp": 1484693212959
            },
            {
              "type": "EMAIL",
              "value": "new-email@hubspot.com",
              "timestamp": 1484854496353
            }
          ]
        }
      ],
      "merge-audits": []
    }
  ],
  "has-more": true,
  "vid-offset": 3714024,
  "time-offset": 1484854580823
}

​
Required Scopes

This API requires one of the following scopes:
  • crm.objects.contacts.read
  • content
  • crm.objects.contacts.write

Query Parameters

​
count
string

This parameter lets you specify the amount of contacts to return in your API call. The default for this parameter (if it isn't specified) is 20 contacts. The maximum amount of contacts you can have returned to you via this parameter is 100.

​
timeOffset
string

One method used to page through the recent contacts. Every call to this endpoint will return a time-offset value. This value is used in the timeOffset parameter of the next call to get the next page of contacts. The preferred method of paging.

​
vidOffset
string

Another method used to page through the recent contacts. Every call to this endpoint will return a vid-offset value. This value is used in the vidOffset parameter of the next call to get the next page of contacts.

​
property
string

If you include the "property" parameter, then the properties in the "contact" object in the returned data will only include the property or properties that you request.

​
propertyMode
string

One of value_only or value_and_history to specify if the current value for a property should be fetched, or the value and all the historical values for that property. Default is value_only.

​
formSubmissionMode
string

One of all, none, newest, oldest to specify which form submissions should be fetched. Default is newest.

​
showListMemberships
string

Boolean true or false to indicate whether current list memberships should be fetched for the contact. Default is false.

Response

200 - application/json

Successful response - The get recently updated and created contacts endpoint is used to return information about all contacts for a given account that were updated or created in the last 30 days

The response is of type object.