contacts: Contacts endpoint (raw and tidy)

Description Usage Arguments Details Value Examples

Description

Get raw and tidy results from the contacts endpoint.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
hs_contacts_raw(
  token_path = hubspot_token_get(),
  apikey = hubspot_key_get(),
  properties = hs_contact_properties_tidy(hs_contact_properties_raw(token_path =
    token_path, apikey = apikey)),
  property_history = "true",
  form_submission_mode = "newest",
  list_memberships = "false",
  max_iter = 10,
  max_properties = 100
)

hs_contacts_tidy(contacts = hs_contacts_raw(), view = c("properties"))

Arguments

token_path

Path to OAuth 2.0 token. See hubspot_token_create().

apikey

API key to work with Hubspot (only used if token_path is NULL). See hubspot_key_set().

properties

Character vector of properties to request

property_history

Whether version history for properties should be returned

form_submission_mode

Which form submissions should be fetched

list_memberships

Indicate whether current list memberships should be fetched

max_iter

The API is limited to a certain number of responses by page, use max_iter to limit how many pages of data will get returned

max_properties

Avoid URLs that are too long, limit the number of properties returned, if required.

contacts

A contacts return from hs_contacts_raw()

view

A view (see Details)

Details

Required scope(s) of the OAuth token: contacts.

Different view values and associated output.

Value

List with contact data (hs_contacts_raw())

A tibble with associated entities (hs_contacts_tidy())

Examples

1
2
3
4
5
6
7
8
contacts <- hs_contacts_raw(
  property_history = "false", max_iter = 1,
  max_properties = 10
)
contacts_properties <- hs_contacts_tidy(
  contacts,
  view = "properties"
)

lockedata/hubspot documentation built on March 1, 2020, 8:54 p.m.