gem install r_hapi

sudo gem install r_hapi

RHapi.configure do |config|
  config.api_key = "YOUR_API_KEY"
  config.access_token = "YOUR_ACCESS_TOKEN" # Takes precedence over api_key
end

RHapi::Contact.create('email' => '[email protected]')

contact = RHapi::Contact.new
contact.properties.email = '[email protected]'
contact.save # Can also call contact.update

contact.properties.email = '[email protected]' # Defining properties for a new contact
contact = contact.save # => Will replace the object with the newly created version returned from Hubspot

contact.properties.firstname = 'John' # Update local property for an existing contact
contact.save # Local object state is synchronized with hubspot

contact.update # instance of RHapi::Contact object with changes made

contact.update_attribute('firstname', 'John') # Updates and calls save

contact.update_attributes('firstname' => 'John', 'lastname' => 'Doe') # Updates and calls save

contact.properties.firstname = 'John'
contact.properties.lastname = 'Doe'
contact.update # can also call contact.save

contact.delete # Given existing Contact object
# => true

all_contacts = RHapi::Contact.all # Returns RHapi::ContactAll object
all_contacts.contacts # Contains array of Contact objects
# Access each Contact
all_contacts.contacts.each do |contact|
  puts contact.properties.firstname
end

all = RHapi::Contact.all
all.next(5) # Reloads ContactAll object with the next 5 contacts
all.next # Reloads with the last used count (5 here, 20 on a new ContactAll instance)
all.page(5) # Reloads to the given page number (contacts per page defaults to same rules as next method)
all.page(5, 100) # Reloads to the 5th page of contacts with 100 per page (the maximum allowed by Hubspot)
all.previous # Same default rules as next
all.previous(15) # Page back by 15 contacts
all.prev # Alias for all.previous
# You can set the count and vidOffset properties for the object yourself
all.vidOffset = 100
all.count = 20
# Reload based on parameters you have set 
all.refresh_query # Equivalent here to all.page(5, 20) based on defined properties
# refresh and reload are aliases to refresh_query 
all = RHapi::Contact.all(:count => 5) # Define count on initial search in constructor

recent = RHapi::Contact.recent # Returns RHapi::ContactRecent object
recent.contacts # Contains array of Contact objects
# Access each Contact
recent.contacts.each do |contact|
  puts contact.properties.firstname
end

recent = RHapi::Contact.recent
recent.next # Pages forward - same rules as ContactAll objects (20 here)
recent.next(5) # Next 5 contacts
recent.next # Next 5 contacts

contact = RHapi::Contact.find_by_vid(5) # Finds contact with vid 5

contact = RHapi::Contact.find_by_email('[email protected]') # Finds contact with given email

contact = RHapi::Contact.find_by_token(utk) # Finds a contact with the given hubspot utk value

results = RHapi::Contact.find('John') # Searches common fields for query, defaults to 20 results
# You can also call with the search method alias
results = RHapi::Contact.search('John Doe', :count => 100) # Searches with count (max 100)
results # => RHapi::ContactSearch object
results.contacts # Array of Contact objects
results.contacts.each do |contact|
  puts contact.properties.firstname
end

results # existing ContactSearch object 
results.refresh_query('Jane Doe') # Reloads with new query
results.refresh('Jane Doe', :count => 50) # Can supply count and call with refresh or reload alias
results.query = 'John Doe'
results.offset = 5 # used for count
results.reload

statistics = RHapi::Contact.statistics # Returns RHapi::ContactStatistic object
statistics.contacts # => Contact count
statistics.lastNewContactAt # => timestamp
Time.at(statistics.lastNewContactAt).to_datetime # Return datetime object from lastNewContactAt

leads = RHapi::Lead.find
leads.each do |lead|
  puts lead.first_name
  puts lead.last_name
  puts lead.city
  puts lead.state
  puts lead.guid
end

leads = RHapi::Lead.find("Barny")

options = {
  :sort       => "lastName",          # Possible sort values include: firstName, lastName, email, address, phone, insertedAt, lastConvertedAt, lastModifiedAt, closedAt
  :dir        => "asc",               # Use desc for descending.
  :max        => 25,                  # Maximum value is 100
  :offset     => 50,                  # Used in combination with max for paging results. 
  :startTime  => 1298721462000,       # Expressed as milliseconds since epoch time. Returned list will have only leads inserted after this time. Default is 0 and returns all leads up to max.
  :stopTime   => 1298721462000,       # Expressed as milliseconds since epoch time. 
  :timePivot  => "insertedAt",        # The field the start and stop times should be applied to in the search. Can be: insertedAt, firstConvertedAt, lastConvertedAt, lastModifiedAt, closedAt.
  :excludeConversionEvents => false,  # Used to exclude all items in the leadConversionEvents collection from the API results.
  :optout                  => false,  # Set to true to include only leads that have unsubscribed from lead nurturing. The default value, false, includes all leads. 
  :eligibleForEmail        => false,  # Set to true to include only leads eligible for email marketing.
  :bounced                 => false,  # Set to true to include only leads that HubSpot has tried to email, and the email bounced. The default value, false, includes all leads.
  :notImported             => false  # Set to true to include only web leads. The default value, false, includes both imported and web leads.
}
leads = RHapi::Lead.find("Barny", options)

lead = leads.first
lead.first_name = "Fred"
lead.last_name  = "Flintsone"
lead.update

params = {:first_name => "Fred", :last_name => "Flintstone", :city => "Bedrock"}
lead.update(params)

lead = RHapi::Lead.find_by_guid(lead.guid)