hubspot-ruby 0.1.0 → 0.1.1

data/Rakefile

@@ -25,8 +25,6 @@ Jeweler::Tasks.new do |gem|
   gem.version = Hubspot::Version::STRING
 
   # dependencies defined in Gemfile
-  gem.add_dependency "activesupport", ">=3.0.0"
-  gem.add_dependency "httparty", ">=0.10.0"
 end
 Jeweler::RubygemsDotOrgTasks.new
 

data/hubspot-ruby.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "hubspot-ruby"
-  s.version = "0.1.0"
+  s.version = "0.1.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Andrew DiMichele"]
-  s.date = "2013-02-18"
+  s.date = "2013-02-22"
   s.description = "hubspot-ruby is a wrapper for the HubSpot REST API"
   s.email = "andrew@omadahealth.com"
   s.extra_rdoc_files = [
@@ -28,12 +28,17 @@ Gem::Specification.new do |s|
     "lib/hubspot-ruby.rb",
     "lib/hubspot/config.rb",
     "lib/hubspot/contact.rb",
+    "lib/hubspot/exceptions.rb",
     "lib/hubspot/utils.rb",
     "lib/hubspot/version.rb",
-    "spec/fixtures/vcr_cassettes/example_contact.yml",
-    "spec/fixtures/vcr_cassettes/find_contact_by_email.yml",
-    "spec/fixtures/vcr_cassettes/find_contact_by_id.yml",
-    "spec/fixtures/vcr_cassettes/update_contact.yml",
+    "spec/fixtures/vcr_cassettes/contact_create.yml",
+    "spec/fixtures/vcr_cassettes/contact_create_existing_email.yml",
+    "spec/fixtures/vcr_cassettes/contact_create_invalid_email.yml",
+    "spec/fixtures/vcr_cassettes/contact_create_with_params.yml",
+    "spec/fixtures/vcr_cassettes/contact_example.yml",
+    "spec/fixtures/vcr_cassettes/contact_find_by_email.yml",
+    "spec/fixtures/vcr_cassettes/contact_find_by_id.yml",
+    "spec/fixtures/vcr_cassettes/contact_update.yml",
     "spec/lib/hubspot-ruby_spec.rb",
     "spec/lib/hubspot/config_spec.rb",
     "spec/lib/hubspot/contact_spec.rb",
@@ -61,8 +66,6 @@ Gem::Specification.new do |s|
       s.add_development_dependency(%q<jeweler>, [">= 0"])
       s.add_development_dependency(%q<simplecov>, [">= 0"])
       s.add_development_dependency(%q<awesome_print>, [">= 0"])
-      s.add_runtime_dependency(%q<activesupport>, [">= 3.0.0"])
-      s.add_runtime_dependency(%q<httparty>, [">= 0.10.0"])
     else
       s.add_dependency(%q<activesupport>, [">= 3.0.0"])
       s.add_dependency(%q<httparty>, [">= 0.10.0"])
@@ -75,8 +78,6 @@ Gem::Specification.new do |s|
       s.add_dependency(%q<jeweler>, [">= 0"])
       s.add_dependency(%q<simplecov>, [">= 0"])
       s.add_dependency(%q<awesome_print>, [">= 0"])
-      s.add_dependency(%q<activesupport>, [">= 3.0.0"])
-      s.add_dependency(%q<httparty>, [">= 0.10.0"])
     end
   else
     s.add_dependency(%q<activesupport>, [">= 3.0.0"])
@@ -90,8 +91,6 @@ Gem::Specification.new do |s|
     s.add_dependency(%q<jeweler>, [">= 0"])
     s.add_dependency(%q<simplecov>, [">= 0"])
     s.add_dependency(%q<awesome_print>, [">= 0"])
-    s.add_dependency(%q<activesupport>, [">= 3.0.0"])
-    s.add_dependency(%q<httparty>, [">= 0.10.0"])
   end
 end
 

data/lib/hubspot-ruby.rb

@@ -1,5 +1,6 @@
 require 'active_support/core_ext'
 require 'httparty'
+require 'hubspot/exceptions'
 require 'hubspot/config'
 require 'hubspot/contact'
 

data/lib/hubspot/contact.rb

@@ -2,15 +2,40 @@ require 'hubspot/utils'
 require 'httparty'
 
 module Hubspot
+  #
+  # HubSpot Contacts API
+  #
+  # {https://developers.hubspot.com/docs/endpoints#contacts-api}
+  #
   class Contact
+    CREATE_CONTACT_PATH = "/contacts/v1/contact"
     GET_CONTACT_BY_EMAIL_PATH = "/contacts/v1/contact/email/:contact_email/profile"
     GET_CONTACT_BY_ID_PATH = "/contacts/v1/contact/vid/:contact_id/profile"
     UPDATE_CONTACT_PATH = "/contacts/v1/contact/vid/:contact_id/profile"
 
     class << self
+      # Creates a new contact
+      # {https://developers.hubspot.com/docs/methods/contacts/create_contact}
+      # @param email [Hash] unique email of the new contact
+      # @param params [Hash] hash of properties to set on the contact
+      # @return [Hubspot::Contact] the newly created contact
+      def create!(email, params={})
+        params_with_email = params.stringify_keys.merge("email" => email)
+        url = Hubspot::Utils.generate_url(CREATE_CONTACT_PATH)
+        post_data = {properties: Hubspot::Utils.hash_to_properties(params_with_email)}
+        resp = HTTParty.post(url, body: post_data.to_json, format: :json)
+        raise(Hubspot::ContactExistsError.new(resp, "Contact already exists with email: #{email}")) if resp.code == 409
+        raise(Hubspot::RequestError.new(resp, "Cannot create contact with email: #{email}")) unless resp.success?
+        Hubspot::Contact.new(resp.parsed_response)
+      end
+
+      # Finds a contact by email
+      # {https://developers.hubspot.com/docs/methods/contacts/get_contact_by_email}
+      # @param email [String] the email of the contact to find
+      # @return [Hubspot::Contact, nil] the contact found or nil
       def find_by_email(email)
         url = Hubspot::Utils.generate_url(GET_CONTACT_BY_EMAIL_PATH, {contact_email: email})
-        resp = HTTParty.get(url)
+        resp = HTTParty.get(url, format: :json)
         if resp.code == 200
           Hubspot::Contact.new(resp.parsed_response)
         else
@@ -18,15 +43,58 @@ module Hubspot
         end
       end
 
+      # Finds a contact by vid
+      # @param vid [String] the vid of the contact to find
+      # @return [Hubspot::Contact, nil] the contact found or nil
       def find_by_id(vid)
         url = Hubspot::Utils.generate_url(GET_CONTACT_BY_ID_PATH, {contact_id: vid})
-        resp = HTTParty.get(url)
+        resp = HTTParty.get(url, format: :json)
         if resp.code == 200
           Hubspot::Contact.new(resp.parsed_response)
         else
           nil
         end
       end
+
+      # TODO: Finds a contact by its User Token (hubspotutk cookie value)
+      # {https://developers.hubspot.com/docs/methods/contacts/get_contact_by_utk}
+      # @param utk [String] hubspotutk cookie value
+      # @return [Hubspot::Contact, nil] the contact found or nil
+      def find_by_utk(utk)
+        raise NotImplementedError
+      end
+
+      # TODO: Get all contacts
+      # {https://developers.hubspot.com/docs/methods/contacts/get_contacts}
+      # @param count [Fixnum] number of contacts per page; max 100
+      # @return [Hubspot::ContactCollection] the paginated collection of contacts
+      def all(count=100)
+        raise NotImplementedError
+      end
+
+      # TODO: Get recently updated and created contacts
+      # {https://developers.hubspot.com/docs/methods/contacts/get_recently_updated_contacts}
+      # @param count [Fixnum] number of contacts per page; max 100
+      # @return [Hubspot::ContactCollection] the paginated collection of contacts
+      def recent(count=100)
+        raise NotImplementedError
+      end
+
+      # TODO: Search for contacts by various crieria
+      # {https://developers.hubspot.com/docs/methods/contacts/search_contacts}
+      # @param query [String] The search term for what you're searching for
+      # @param count [Fixnum] number of contacts per page; max 100
+      # @return [Hubspot::ContactCollection] the collection of contacts; no pagination
+      def search(query, count=100)
+        raise NotImplementedError
+      end
+
+      # TODO: Get statistics about all contacts
+      # {https://developers.hubspot.com/docs/methods/contacts/get_contact_statistics}
+      # @return [Hash] hash of statistics
+      def statistics
+        raise NotImplementedError
+      end
     end
 
     attr_reader :properties
@@ -45,14 +113,25 @@ module Hubspot
       @properties["email"]
     end
 
+    # Updates the properties of a contact
+    # {https://developers.hubspot.com/docs/methods/contacts/update_contact}
+    # @param params [Hash] hash of properties to update
+    # @return [Hubspot::Contact] self
     def update!(params)
       params.stringify_keys!
       url = Hubspot::Utils.generate_url(UPDATE_CONTACT_PATH, {contact_id: vid})
       query = {"properties" => Hubspot::Utils.hash_to_properties(params)}
-      resp = HTTParty.post(url, body: query.to_json)
-      raise(Hubspot::RequestError.new(resp.response)) unless resp.success?
+      resp = HTTParty.post(url, body: query.to_json, format: :json)
+      raise(Hubspot::RequestError.new(resp)) unless resp.success?
       @properties.merge!(params)
       self
     end
+
+    # TODO: Archives the contact in hubspot
+    # {https://developers.hubspot.com/docs/methods/contacts/delete_contact}
+    # @return [nil]
+    def destroy!
+      raise NotImplementedError
+    end
   end
 end

data/lib/hubspot/exceptions.rb

@@ -0,0 +1,12 @@
+module Hubspot
+  class RequestError < StandardError
+    def initialize(response, message=nil)
+      message += "\n" if message
+      super("#{message}Response body: #{response.body}")
+    end
+  end
+
+  class ConfigurationError < StandardError; end
+  class MissingInterpolation < StandardError; end
+  class ContactExistsError < RequestError; end
+end

data/lib/hubspot/utils.rb

@@ -1,8 +1,4 @@
 module Hubspot
-  class ConfigurationError < StandardError; end
-  class MissingInterpolation < StandardError; end
-  class RequestError < StandardError; end
-
   class Utils
     class << self
       # Parses the hubspot properties format into a key-value hash
@@ -26,17 +22,18 @@ module Hubspot
       #
       def generate_url(path, params={})
         raise Hubspot::ConfigurationError.new("'hapikey' not configured") unless Hubspot::Config.hapikey
+        path = path.clone
+        params = params.clone
         params["hapikey"] = Hubspot::Config.hapikey
-        ipath = path.clone
         params.each do |k,v|
-          if ipath.match(":#{k}")
-            ipath.gsub!(":#{k}",v.to_s)
+          if path.match(":#{k}")
+            path.gsub!(":#{k}",v.to_s)
             params.delete(k)
           end
         end
-        raise(Hubspot::MissingInterpolation.new("Interpolation not resolved")) if ipath =~ /:/
+        raise(Hubspot::MissingInterpolation.new("Interpolation not resolved")) if path =~ /:/
         query = params.map{ |k,v| "#{k}=#{v}" }.join("&")
-        Hubspot::Config.base_url + ipath + "?" + query
+        Hubspot::Config.base_url + path + "?" + query
       end
     end
   end

data/lib/hubspot/version.rb

@@ -2,7 +2,7 @@ module Hubspot
   module Version
     MAJOR = 0
     MINOR = 1
-    PATCH = 0
+    PATCH = 1
 
     STRING = [MAJOR, MINOR, PATCH].compact.join('.')
   end

data/spec/fixtures/vcr_cassettes/contact_create.yml

@@ -0,0 +1,32 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.hubapi.com/contacts/v1/contact?hapikey=demo
+    body:
+      encoding: US-ASCII
+      string: ! '{"properties":[{"property":"email","value":"newcontact1361564912@hsgem.com"}]}'
+    headers: {}
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Access-Control-Allow-Credentials:
+      - 'false'
+      Content-Type:
+      - text/plain; charset=utf-8
+      Date:
+      - Fri, 22 Feb 2013 20:28:34 GMT
+      Server:
+      - Apache-Coyote/1.1
+      Content-Length:
+      - '1084'
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! '{"vid":154963,"portal-id":62515,"profile-token":"AO_T-mO_ghCK-Ia-VTb9_2r9z6sSvJu1gQkVT4Y0GmhKxIP-e3PyPRBHyhh4qeC-yu-5881gXoLArqPN2BvJu9MSJLXCSyJNZjyX0hkD2yvbnkrKBZtpXjS1XtQL2R8VinrL5AZAQ073","profile-url":"https://app.hubspot.com/contacts/62515/lists/public/contact/_AO_T-mO_ghCK-Ia-VTb9_2r9z6sSvJu1gQkVT4Y0GmhKxIP-e3PyPRBHyhh4qeC-yu-5881gXoLArqPN2BvJu9MSJLXCSyJNZjyX0hkD2yvbnkrKBZtpXjS1XtQL2R8VinrL5AZAQ073/","properties":{"email":{"value":"newcontact1361564912@hsgem.com","versions":[{"value":"newcontact1361564912@hsgem.com","source-type":"API","source-id":null,"source-label":null,"timestamp":1361564913945,"selected":false}]},"createdate":{"value":"1361564913945","versions":[{"value":"1361564913945","source-type":"API","source-id":null,"source-label":null,"timestamp":1361564913945,"selected":false}]}},"form-submissions":[],"list-memberships":[],"identity-profiles":[{"vid":154963,"identities":[{"type":"EMAIL","value":"newcontact1361564912@hsgem.com","timestamp":1361564913945},{"type":"LEAD_GUID","value":"b8c6e48e-e5b3-4322-b192-27ec5629175e","timestamp":1361564913954}]}]}'
+    http_version: 
+  recorded_at: Fri, 22 Feb 2013 20:28:34 GMT
+recorded_with: VCR 2.4.0

data/spec/fixtures/vcr_cassettes/contact_create_existing_email.yml

@@ -0,0 +1,30 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.hubapi.com/contacts/v1/contact?hapikey=demo
+    body:
+      encoding: US-ASCII
+      string: ! '{"properties":[{"property":"email","value":"testingapis@hubspot.com"}]}'
+    headers: {}
+  response:
+    status:
+      code: 409
+      message: Conflict
+    headers:
+      Content-Type:
+      - application/json;charset=UTF-8
+      Date:
+      - Fri, 22 Feb 2013 20:28:35 GMT
+      Server:
+      - Apache-Coyote/1.1
+      Content-Length:
+      - '380'
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! '{"status":"error","message":"{\"msg\":\"Contact already existed\",\"error\":\"CONTACT_EXISTS\",\"property\":{\"vid\":82325,\"identities\":[{\"type\":\"EMAIL\",\"value\":\"testingapis@hubspot.com\",\"timestamp\":1345062449327},{\"type\":\"LEAD_GUID\",\"value\":\"c0da5c41-f289-4642-910c-9aa2b0fba245\",\"timestamp\":1345062449333}]}}","guid":"cd0e6f59-c8a3-4ae5-b897-3b3990ebda40"}'
+    http_version: 
+  recorded_at: Fri, 22 Feb 2013 20:28:35 GMT
+recorded_with: VCR 2.4.0

data/spec/fixtures/vcr_cassettes/contact_create_invalid_email.yml

@@ -0,0 +1,31 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.hubapi.com/contacts/v1/contact?hapikey=demo
+    body:
+      encoding: US-ASCII
+      string: ! '{"properties":[{"property":"email","value":"not_an_email"}]}'
+    headers: {}
+  response:
+    status:
+      code: 400
+      message: Bad Request
+    headers:
+      Content-Type:
+      - application/json;charset=UTF-8
+      Date:
+      - Fri, 22 Feb 2013 20:28:36 GMT
+      Server:
+      - Apache-Coyote/1.1
+      Content-Length:
+      - '177'
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! '{"status":"error","message":"Invalid value for type in identity:
+        value: \"not_an_email\"\ntype: EMAIL\ntimestamp: 1361564916579\n","guid":"74dee415-f9fd-4525-83e6-436df7c2aa56"}'
+    http_version: 
+  recorded_at: Fri, 22 Feb 2013 20:28:36 GMT
+recorded_with: VCR 2.4.0

data/spec/fixtures/vcr_cassettes/contact_create_with_params.yml

@@ -0,0 +1,32 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.hubapi.com/contacts/v1/contact?hapikey=demo
+    body:
+      encoding: US-ASCII
+      string: ! '{"properties":[{"property":"firstname","value":"Hugh"},{"property":"lastname","value":"Jackman"},{"property":"email","value":"newcontact_x_1361564914@hsgem.com"}]}'
+    headers: {}
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Access-Control-Allow-Credentials:
+      - 'false'
+      Content-Type:
+      - text/plain; charset=utf-8
+      Date:
+      - Fri, 22 Feb 2013 20:28:35 GMT
+      Server:
+      - Apache-Coyote/1.1
+      Content-Length:
+      - '1416'
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! '{"vid":154964,"portal-id":62515,"profile-token":"AO_T-mMaMO14Jys0CrLFvkD56Xc8f7PvvFmhsvSPDDdm6-6uF2wbsFHaXFthseHCDcYvwjiWsMGmF9JSy1cdRpd2-PHwsGHsvBwWTwTDSH7cfTId6uYx7xpng_5YxQM9KauZgI_NJMKL","profile-url":"https://app.hubspot.com/contacts/62515/lists/public/contact/_AO_T-mMaMO14Jys0CrLFvkD56Xc8f7PvvFmhsvSPDDdm6-6uF2wbsFHaXFthseHCDcYvwjiWsMGmF9JSy1cdRpd2-PHwsGHsvBwWTwTDSH7cfTId6uYx7xpng_5YxQM9KauZgI_NJMKL/","properties":{"email":{"value":"newcontact_x_1361564914@hsgem.com","versions":[{"value":"newcontact_x_1361564914@hsgem.com","source-type":"API","source-id":null,"source-label":null,"timestamp":1361564915163,"selected":false}]},"createdate":{"value":"1361564915163","versions":[{"value":"1361564915163","source-type":"API","source-id":null,"source-label":null,"timestamp":1361564915163,"selected":false}]},"lastname":{"value":"Jackman","versions":[{"value":"Jackman","source-type":"API","source-id":null,"source-label":null,"timestamp":1361564915163,"selected":false}]},"firstname":{"value":"Hugh","versions":[{"value":"Hugh","source-type":"API","source-id":null,"source-label":null,"timestamp":1361564915163,"selected":false}]}},"form-submissions":[],"list-memberships":[],"identity-profiles":[{"vid":154964,"identities":[{"type":"EMAIL","value":"newcontact_x_1361564914@hsgem.com","timestamp":1361564915163},{"type":"LEAD_GUID","value":"49034e6d-f3f4-4018-8b50-1baa22cdb514","timestamp":1361564915173}]}]}'
+    http_version: 
+  recorded_at: Fri, 22 Feb 2013 20:28:35 GMT
+recorded_with: VCR 2.4.0

data/spec/fixtures/vcr_cassettes/contact_example.yml

@@ -0,0 +1,32 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.hubapi.com/contacts/v1/contact/email/testingapis@hubspot.com/profile?hapikey=demo
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers: {}
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Access-Control-Allow-Credentials:
+      - 'false'
+      Content-Type:
+      - application/json;charset=UTF-8
+      Date:
+      - Fri, 22 Feb 2013 20:31:02 GMT
+      Server:
+      - Apache-Coyote/1.1
+      Content-Length:
+      - '5094'
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! '{"vid":82325,"canonical-vid":82325,"portal-id":62515,"profile-token":"AO_T-mNv5DxWksowkR_cUZwe4J5-pxmNlzGQ4bJOas20MGNrJtrQWj7vtreBvekW74KmTCsbeEx0Kwy3YfptnFT6fDiQ-3kEnQz44wTQsEvmusYBjUYqvfv0twCciwlZ1vCwerCEuRUo","profile-url":"https://app.hubspot.com/contacts/62515/lists/public/contact/_AO_T-mNv5DxWksowkR_cUZwe4J5-pxmNlzGQ4bJOas20MGNrJtrQWj7vtreBvekW74KmTCsbeEx0Kwy3YfptnFT6fDiQ-3kEnQz44wTQsEvmusYBjUYqvfv0twCciwlZ1vCwerCEuRUo/","properties":{"hs_analytics_num_visits":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_referrer":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_linkedin_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_url":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_last_engagement":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_num_broadcast_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"hs_social_facebook_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"createdate":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"API","source-id":null,"source-label":null,"timestamp":1345062449002,"selected":false}]},"lastname":{"value":"Eastwood","versions":[{"value":"Eastwood","source-type":"API","source-id":null,"source-label":null,"timestamp":1361147932002,"selected":false},{"value":"Cunningham","source-type":"API","source-id":null,"source-label":null,"timestamp":1361146313002,"selected":false}]},"hs_social_twitter_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"phone":{"value":"555-555-5432"},"firstname":{"value":"Clint","versions":[{"value":"Clint","source-type":"API","source-id":null,"source-label":null,"timestamp":1361147932002,"selected":false},{"value":"Steve","source-type":"API","source-id":null,"source-label":null,"timestamp":1361146313002,"selected":false}]},"hs_analytics_first_url":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source":{"value":"OFFLINE","versions":[{"value":"OFFLINE","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_first_referrer":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_num_event_completions":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"hs_social_google_plus_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"email":{"value":"testingapis@hubspot.com","versions":[{"value":"testingapis@hubspot.com","source-type":"CONTACTS_WEB","source-id":"dadams@hubspot.com","source-label":null,"timestamp":1345062449008,"selected":false}]},"hs_analytics_last_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_num_page_views":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_first_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source_data_2":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source_data_1":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_visit_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]}},"form-submissions":[],"list-memberships":[],"identity-profiles":[{"vid":82325,"identities":[{"type":"EMAIL","value":"testingapis@hubspot.com","timestamp":1345062449327},{"type":"LEAD_GUID","value":"c0da5c41-f289-4642-910c-9aa2b0fba245","timestamp":1345062449333}]}]}'
+    http_version: 
+  recorded_at: Fri, 22 Feb 2013 20:31:02 GMT
+recorded_with: VCR 2.4.0

data/spec/fixtures/vcr_cassettes/contact_find_by_email.yml

@@ -0,0 +1,59 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.hubapi.com/contacts/v1/contact/email/testingapis@hubspot.com/profile?hapikey=demo
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers: {}
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Access-Control-Allow-Credentials:
+      - 'false'
+      Content-Type:
+      - application/json;charset=UTF-8
+      Date:
+      - Fri, 22 Feb 2013 20:29:42 GMT
+      Server:
+      - Apache-Coyote/1.1
+      Content-Length:
+      - '5094'
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! '{"vid":82325,"canonical-vid":82325,"portal-id":62515,"profile-token":"AO_T-mNUsbKKM-tvm_q0O7Ql1xQiWoedwmogZpyxE-rxo0onAmthqACf0UP7bZSHxumyp1tZAdD-Gx3_aLPT2M8W9zCHxEl-Mn0tQezqgf_Wtz4TeT89Zue-LLJ2bug1MkR2ALQyrk9L","profile-url":"https://app.hubspot.com/contacts/62515/lists/public/contact/_AO_T-mNUsbKKM-tvm_q0O7Ql1xQiWoedwmogZpyxE-rxo0onAmthqACf0UP7bZSHxumyp1tZAdD-Gx3_aLPT2M8W9zCHxEl-Mn0tQezqgf_Wtz4TeT89Zue-LLJ2bug1MkR2ALQyrk9L/","properties":{"hs_analytics_num_visits":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_referrer":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_linkedin_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_url":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_last_engagement":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_num_broadcast_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"hs_social_facebook_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"createdate":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"API","source-id":null,"source-label":null,"timestamp":1345062449002,"selected":false}]},"lastname":{"value":"Eastwood","versions":[{"value":"Eastwood","source-type":"API","source-id":null,"source-label":null,"timestamp":1361147932002,"selected":false},{"value":"Cunningham","source-type":"API","source-id":null,"source-label":null,"timestamp":1361146313002,"selected":false}]},"hs_social_twitter_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"firstname":{"value":"Clint","versions":[{"value":"Clint","source-type":"API","source-id":null,"source-label":null,"timestamp":1361147932002,"selected":false},{"value":"Steve","source-type":"API","source-id":null,"source-label":null,"timestamp":1361146313002,"selected":false}]},"hs_analytics_first_url":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source":{"value":"OFFLINE","versions":[{"value":"OFFLINE","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_first_referrer":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_num_event_completions":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"hs_social_google_plus_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"email":{"value":"testingapis@hubspot.com","versions":[{"value":"testingapis@hubspot.com","source-type":"CONTACTS_WEB","source-id":"dadams@hubspot.com","source-label":null,"timestamp":1345062449008,"selected":false}]},"hs_analytics_last_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_num_page_views":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_first_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source_data_2":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source_data_1":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_visit_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]}},"form-submissions":[],"list-memberships":[],"identity-profiles":[{"vid":82325,"identities":[{"type":"EMAIL","value":"testingapis@hubspot.com","timestamp":1345062449327},{"type":"LEAD_GUID","value":"c0da5c41-f289-4642-910c-9aa2b0fba245","timestamp":1345062449333}]}]}'
+    http_version: 
+  recorded_at: Fri, 22 Feb 2013 20:29:42 GMT
+- request:
+    method: get
+    uri: https://api.hubapi.com/contacts/v1/contact/email/notacontact@test.com/profile?hapikey=demo
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers: {}
+  response:
+    status:
+      code: 404
+      message: Not Found
+    headers:
+      Content-Type:
+      - application/json;charset=UTF-8
+      Date:
+      - Fri, 22 Feb 2013 20:29:42 GMT
+      Server:
+      - Apache-Coyote/1.1
+      Content-Length:
+      - '95'
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! '{"status":"error","message":"resource not found","guid":"5aafc293-6bc9-47fb-b6a4-512ffff24e88"}'
+    http_version: 
+  recorded_at: Fri, 22 Feb 2013 20:29:42 GMT
+recorded_with: VCR 2.4.0

data/spec/fixtures/vcr_cassettes/contact_find_by_id.yml

@@ -0,0 +1,59 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.hubapi.com/contacts/v1/contact/vid/82325/profile?hapikey=demo
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers: {}
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Access-Control-Allow-Credentials:
+      - 'false'
+      Content-Type:
+      - application/json;charset=UTF-8
+      Date:
+      - Fri, 22 Feb 2013 20:29:43 GMT
+      Server:
+      - Apache-Coyote/1.1
+      Content-Length:
+      - '5094'
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! '{"vid":82325,"canonical-vid":82325,"portal-id":62515,"profile-token":"AO_T-mN82Ph5EzbxdO0UKGfnTGctmSbIcuJYxQEaRfQm2N8ln86VOZ60vLFdYpSpnT9uoGqu_joSKihWulaj7CE4pna4f4bM_EPcG26pT4nY1bDkzoOtxUSLb82cOvFPMicWnaF_1dz-","profile-url":"https://app.hubspot.com/contacts/62515/lists/public/contact/_AO_T-mN82Ph5EzbxdO0UKGfnTGctmSbIcuJYxQEaRfQm2N8ln86VOZ60vLFdYpSpnT9uoGqu_joSKihWulaj7CE4pna4f4bM_EPcG26pT4nY1bDkzoOtxUSLb82cOvFPMicWnaF_1dz-/","properties":{"hs_analytics_num_visits":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_referrer":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_linkedin_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_url":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_last_engagement":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_num_broadcast_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"hs_social_facebook_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"createdate":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"API","source-id":null,"source-label":null,"timestamp":1345062449002,"selected":false}]},"lastname":{"value":"Eastwood","versions":[{"value":"Eastwood","source-type":"API","source-id":null,"source-label":null,"timestamp":1361147932002,"selected":false},{"value":"Cunningham","source-type":"API","source-id":null,"source-label":null,"timestamp":1361146313002,"selected":false}]},"hs_social_twitter_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"firstname":{"value":"Clint","versions":[{"value":"Clint","source-type":"API","source-id":null,"source-label":null,"timestamp":1361147932002,"selected":false},{"value":"Steve","source-type":"API","source-id":null,"source-label":null,"timestamp":1361146313002,"selected":false}]},"hs_analytics_first_url":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source":{"value":"OFFLINE","versions":[{"value":"OFFLINE","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_first_referrer":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_num_event_completions":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"hs_social_google_plus_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"email":{"value":"testingapis@hubspot.com","versions":[{"value":"testingapis@hubspot.com","source-type":"CONTACTS_WEB","source-id":"dadams@hubspot.com","source-label":null,"timestamp":1345062449008,"selected":false}]},"hs_analytics_last_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_num_page_views":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_first_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source_data_2":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source_data_1":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_visit_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]}},"form-submissions":[],"list-memberships":[],"identity-profiles":[{"vid":82325,"identities":[{"type":"EMAIL","value":"testingapis@hubspot.com","timestamp":1345062449327},{"type":"LEAD_GUID","value":"c0da5c41-f289-4642-910c-9aa2b0fba245","timestamp":1345062449333}]}]}'
+    http_version: 
+  recorded_at: Fri, 22 Feb 2013 20:29:43 GMT
+- request:
+    method: get
+    uri: https://api.hubapi.com/contacts/v1/contact/vid/9999999/profile?hapikey=demo
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers: {}
+  response:
+    status:
+      code: 404
+      message: Not Found
+    headers:
+      Content-Type:
+      - application/json;charset=UTF-8
+      Date:
+      - Fri, 22 Feb 2013 20:29:45 GMT
+      Server:
+      - Apache-Coyote/1.1
+      Content-Length:
+      - '95'
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! '{"status":"error","message":"resource not found","guid":"06364bc0-92ce-4c4f-b62e-dc8f1428cdfa"}'
+    http_version: 
+  recorded_at: Fri, 22 Feb 2013 20:29:45 GMT
+recorded_with: VCR 2.4.0

data/spec/fixtures/vcr_cassettes/{update_contact.yml → contact_update.yml}

@@ -1,30 +1,5 @@
 ---
 http_interactions:
-- request:
-    method: post
-    uri: https://api.hubapi.com/contacts/v1/contact/vid/82325/profile?hapikey=demo
-    body:
-      encoding: US-ASCII
-      string: ! '{"properties":[{"property":"firstname","value":"Steve"},{"property":"lastname","value":"Cunningham"}]}'
-    headers: {}
-  response:
-    status:
-      code: 204
-      message: No Content
-    headers:
-      Access-Control-Allow-Credentials:
-      - 'false'
-      Date:
-      - Mon, 18 Feb 2013 00:11:53 GMT
-      Server:
-      - Apache-Coyote/1.1
-      Connection:
-      - keep-alive
-    body:
-      encoding: US-ASCII
-      string: ''
-    http_version: 
-  recorded_at: Mon, 18 Feb 2013 00:11:53 GMT
 - request:
     method: post
     uri: https://api.hubapi.com/contacts/v1/contact/vid/invalid/profile?hapikey=demo
@@ -40,7 +15,7 @@ http_interactions:
       Content-Type:
       - text/html;charset=utf-8
       Date:
-      - Mon, 18 Feb 2013 00:11:54 GMT
+      - Fri, 22 Feb 2013 20:29:45 GMT
       Server:
       - Apache-Coyote/1.1
       Content-Length:
@@ -62,5 +37,30 @@ http_interactions:
         requested resource (Not Found) is not available.</u></p><HR size="1" noshade="noshade"><h3>Apache
         Tomcat/6.0.30</h3></body></html>'
     http_version: 
-  recorded_at: Mon, 18 Feb 2013 00:11:54 GMT
+  recorded_at: Fri, 22 Feb 2013 20:29:46 GMT
+- request:
+    method: post
+    uri: https://api.hubapi.com/contacts/v1/contact/vid/82325/profile?hapikey=demo
+    body:
+      encoding: US-ASCII
+      string: ! '{"properties":[{"property":"firstname","value":"Steve"},{"property":"lastname","value":"Cunningham"}]}'
+    headers: {}
+  response:
+    status:
+      code: 204
+      message: No Content
+    headers:
+      Access-Control-Allow-Credentials:
+      - 'false'
+      Date:
+      - Fri, 22 Feb 2013 20:31:03 GMT
+      Server:
+      - Apache-Coyote/1.1
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ''
+    http_version: 
+  recorded_at: Fri, 22 Feb 2013 20:31:03 GMT
 recorded_with: VCR 2.4.0

data/spec/lib/hubspot/contact_spec.rb

@@ -2,7 +2,7 @@ require 'spec_helper'
 
 describe Hubspot::Contact do
   let(:example_contact_hash) do
-    VCR.use_cassette("example_contact", record: :none) do
+    VCR.use_cassette("contact_example", record: :none) do
       HTTParty.get("https://api.hubapi.com/contacts/v1/contact/email/testingapis@hubspot.com/profile?hapikey=demo").parsed_response
     end
   end
@@ -13,14 +13,49 @@ describe Hubspot::Contact do
     subject{ Hubspot::Contact.new(example_contact_hash) }
     it{ should be_an_instance_of Hubspot::Contact }
     its(["email"]){ should == "testingapis@hubspot.com" }
-    its(["firstname"]){ should == "Test" }
-    its(["lastname"]){ should == "Contact" }
-    its(["phone"]){ should == "555-555-2262" }
+    its(["firstname"]){ should == "Clint" }
+    its(["lastname"]){ should == "Eastwood" }
+    its(["phone"]){ should == "555-555-5432" }
     its(:vid){ should == 82325 }
   end
 
+  describe ".create!" do
+    let(:cassette){ "contact_create" }
+    before{ VCR.insert_cassette(cassette, record: :new_episodes) }
+    after{ VCR.eject_cassette }
+    let(:params){{}}
+    subject{ Hubspot::Contact.create!(email, params) }
+    context "with a new email" do
+      let(:email){ "newcontact#{Time.now.to_i}@hsgem.com" }
+      it{ should be_an_instance_of Hubspot::Contact }
+      its(:email){ should match /newcontact.*@hsgem.com/ } # Due to VCR the email may not match exactly
+
+      context "and some params" do
+        let(:cassette){ "contact_create_with_params" }
+        let(:email){ "newcontact_x_#{Time.now.to_i}@hsgem.com" }
+        let(:params){ {firstname: "Hugh", lastname: "Jackman" } }
+        its(["firstname"]){ should == "Hugh"}
+        its(["lastname"]){ should == "Jackman"}
+      end
+    end
+    context "with an existing email" do
+      let(:cassette){ "contact_create_existing_email" }
+      let(:email){ "testingapis@hubspot.com" }
+      it "raises a ContactExistsError" do
+        expect{ subject }.to raise_error Hubspot::ContactExistsError
+      end
+    end
+    context "with an invalid email" do
+      let(:cassette){ "contact_create_invalid_email" }
+      let(:email){ "not_an_email" }
+      it "raises a RequestError" do
+        expect{ subject }.to raise_error Hubspot::RequestError
+      end
+    end
+  end
+
   describe ".find_by_email" do
-    before{ VCR.insert_cassette("find_contact_by_email", record: :new_episodes) }
+    before{ VCR.insert_cassette("contact_find_by_email", record: :new_episodes) }
     after{ VCR.eject_cassette }
     subject{ Hubspot::Contact.find_by_email(email) }
 
@@ -37,7 +72,7 @@ describe Hubspot::Contact do
   end
 
   describe ".find_by_id" do
-    before{ VCR.insert_cassette("find_contact_by_id", record: :new_episodes) }
+    before{ VCR.insert_cassette("contact_find_by_id", record: :new_episodes) }
     after{ VCR.eject_cassette }
     subject{ Hubspot::Contact.find_by_id(vid) }
 
@@ -54,7 +89,7 @@ describe Hubspot::Contact do
   end
 
   describe "#update!" do
-    before{ VCR.insert_cassette("update_contact", record: :new_episodes) }
+    before{ VCR.insert_cassette("contact_update", record: :new_episodes) }
     after{ VCR.eject_cassette }
     let(:contact){ Hubspot::Contact.new(example_contact_hash) }
     let(:params){ {firstname: "Steve", lastname: "Cunningham"} }

data/spec/lib/hubspot/utils_spec.rb

@@ -33,10 +33,14 @@ describe Hubspot::Utils do
 
   describe ".generate_url" do
     let(:path){ "/test/:email/profile" }
-    let(:params){{}}
+    let(:params){{email: "test"}}
     subject{ Hubspot::Utils.generate_url(path, params) }
     before{ Hubspot.configure(hapikey: "demo") }
 
+    it "doesn't modify params" do
+      expect{ subject }.to_not change{params}
+    end
+
     context "when configure hasn't been called" do
       before{ Hubspot::Config.reset! }
       it "raises a config exception" do
@@ -45,6 +49,7 @@ describe Hubspot::Utils do
     end
 
     context "with interpolations but no params" do
+      let(:params){{}}
       it "raises an interpolation exception" do
         expect{ subject }.to raise_error Hubspot::MissingInterpolation
       end

data/spec/live/contacts_integration_spec.rb

@@ -12,4 +12,6 @@ describe "Contacts API Live test", live: true do
     contact["firstname"].should == "Clint"
     contact["lastname"].should == "Eastwood"
   end
+
+  pending "creates and destroys a contact"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hubspot-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-18 00:00:00.000000000 Z
+date: 2013-02-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -187,38 +187,6 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: activesupport
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 3.0.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 3.0.0
-- !ruby/object:Gem::Dependency
-  name: httparty
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 0.10.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 0.10.0
 description: hubspot-ruby is a wrapper for the HubSpot REST API
 email: andrew@omadahealth.com
 executables: []
@@ -238,12 +206,17 @@ files:
 - lib/hubspot-ruby.rb
 - lib/hubspot/config.rb
 - lib/hubspot/contact.rb
+- lib/hubspot/exceptions.rb
 - lib/hubspot/utils.rb
 - lib/hubspot/version.rb
-- spec/fixtures/vcr_cassettes/example_contact.yml
-- spec/fixtures/vcr_cassettes/find_contact_by_email.yml
-- spec/fixtures/vcr_cassettes/find_contact_by_id.yml
-- spec/fixtures/vcr_cassettes/update_contact.yml
+- spec/fixtures/vcr_cassettes/contact_create.yml
+- spec/fixtures/vcr_cassettes/contact_create_existing_email.yml
+- spec/fixtures/vcr_cassettes/contact_create_invalid_email.yml
+- spec/fixtures/vcr_cassettes/contact_create_with_params.yml
+- spec/fixtures/vcr_cassettes/contact_example.yml
+- spec/fixtures/vcr_cassettes/contact_find_by_email.yml
+- spec/fixtures/vcr_cassettes/contact_find_by_id.yml
+- spec/fixtures/vcr_cassettes/contact_update.yml
 - spec/lib/hubspot-ruby_spec.rb
 - spec/lib/hubspot/config_spec.rb
 - spec/lib/hubspot/contact_spec.rb
@@ -264,7 +237,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3359032865728179848
+      hash: 1080958652327679356
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:

data/spec/fixtures/vcr_cassettes/example_contact.yml

@@ -1,32 +0,0 @@
----
-http_interactions:
-- request:
-    method: get
-    uri: https://api.hubapi.com/contacts/v1/contact/email/testingapis@hubspot.com/profile?hapikey=demo
-    body:
-      encoding: US-ASCII
-      string: ''
-    headers: {}
-  response:
-    status:
-      code: 200
-      message: OK
-    headers:
-      Access-Control-Allow-Credentials:
-      - 'false'
-      Content-Type:
-      - application/json;charset=UTF-8
-      Date:
-      - Sun, 17 Feb 2013 21:25:47 GMT
-      Server:
-      - Apache-Coyote/1.1
-      Content-Length:
-      - '4526'
-      Connection:
-      - keep-alive
-    body:
-      encoding: US-ASCII
-      string: ! '{"vid":82325,"canonical-vid":82325,"portal-id":62515,"profile-token":"AO_T-mOFl-EsboE0zgQW128L0RgCNNG8B5dPZhYfs7wWibbeR0hPcNdip07vdlt8TTWgDKqvLs-7XByciZlyBnA6_P7AR66hspzqIoBuh2fWiQa231_UEvVohe-lkdfQYv8iCtnAMNVq","profile-url":"https://app.hubspot.com/contacts/62515/lists/public/contact/_AO_T-mOFl-EsboE0zgQW128L0RgCNNG8B5dPZhYfs7wWibbeR0hPcNdip07vdlt8TTWgDKqvLs-7XByciZlyBnA6_P7AR66hspzqIoBuh2fWiQa231_UEvVohe-lkdfQYv8iCtnAMNVq/","properties":{"firstname":{"value":"Test","versions":[{"timestamp":1338305440003,"selected":false,"source-label":"FirstName","value":"Test","source-type":"FORM","source-id":"bc65112f47c2469e90f5951213a66110"}]},"lastname":{"value":"Contact","versions":[{"timestamp":1338305440003,"selected":false,"source-label":"LastName","value":"Contact","source-type":"FORM","source-id":"bc65112f47c2469e90f5951213a66110"}]},"phone":{"value":"555-555-2262","versions":[{"timestamp":1338305440003,"selected":false,"source-label":"Phone","value":"555-555-2262","source-type":"FORM","source-id":"bc65112f47c2469e90f5951213a66110"}]},"hs_analytics_num_visits":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_referrer":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_linkedin_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_url":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_last_engagement":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_num_broadcast_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"hs_social_facebook_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"createdate":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"API","source-id":null,"source-label":null,"timestamp":1345062449002,"selected":false}]},"hs_social_twitter_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_first_url":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_first_referrer":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_num_event_completions":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"hs_analytics_source":{"value":"OFFLINE","versions":[{"value":"OFFLINE","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_google_plus_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"email":{"value":"testingapis@hubspot.com","versions":[{"value":"testingapis@hubspot.com","source-type":"CONTACTS_WEB","source-id":"dadams@hubspot.com","source-label":null,"timestamp":1345062449008,"selected":false}]},"hs_analytics_last_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_num_page_views":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_first_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source_data_2":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source_data_1":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_visit_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]}},"form-submissions":[],"list-memberships":[],"identity-profiles":[{"vid":82325,"identities":[{"type":"EMAIL","value":"testingapis@hubspot.com","timestamp":1345062449327},{"type":"LEAD_GUID","value":"c0da5c41-f289-4642-910c-9aa2b0fba245","timestamp":1345062449333}]}]}'
-    http_version: 
-  recorded_at: Sun, 17 Feb 2013 21:25:47 GMT
-recorded_with: VCR 2.4.0

data/spec/fixtures/vcr_cassettes/find_contact_by_email.yml

@@ -1,59 +0,0 @@
----
-http_interactions:
-- request:
-    method: get
-    uri: https://api.hubapi.com/contacts/v1/contact/email/testingapis@hubspot.com/profile?hapikey=demo
-    body:
-      encoding: US-ASCII
-      string: ''
-    headers: {}
-  response:
-    status:
-      code: 200
-      message: OK
-    headers:
-      Access-Control-Allow-Credentials:
-      - 'false'
-      Content-Type:
-      - application/json;charset=UTF-8
-      Date:
-      - Mon, 18 Feb 2013 00:27:11 GMT
-      Server:
-      - Apache-Coyote/1.1
-      Content-Length:
-      - '4857'
-      Connection:
-      - keep-alive
-    body:
-      encoding: US-ASCII
-      string: ! '{"vid":82325,"canonical-vid":82325,"portal-id":62515,"profile-token":"AO_T-mOEnUzEVVZQVj3XwZCiE87gPcrjLaNbtQmsuVg5c7YUx7BIfMF48rHWdEvZSEpbpX-V7Qz46i0z1hk7KQyH41DJZLQPB2F-aH8qrG1EW-mIZxHl-QmK9Ffo4ILZrKoOwwr3qqZw","profile-url":"https://app.hubspot.com/contacts/62515/lists/public/contact/_AO_T-mOEnUzEVVZQVj3XwZCiE87gPcrjLaNbtQmsuVg5c7YUx7BIfMF48rHWdEvZSEpbpX-V7Qz46i0z1hk7KQyH41DJZLQPB2F-aH8qrG1EW-mIZxHl-QmK9Ffo4ILZrKoOwwr3qqZw/","properties":{"hs_analytics_num_visits":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_referrer":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_linkedin_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_url":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_last_engagement":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_num_broadcast_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"hs_social_facebook_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"createdate":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"API","source-id":null,"source-label":null,"timestamp":1345062449002,"selected":false}]},"lastname":{"value":"Cunningham","versions":[{"value":"Cunningham","source-type":"API","source-id":null,"source-label":null,"timestamp":1361146313002,"selected":false}]},"hs_social_twitter_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"firstname":{"value":"Steve","versions":[{"value":"Steve","source-type":"API","source-id":null,"source-label":null,"timestamp":1361146313002,"selected":false}]},"hs_analytics_first_url":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source":{"value":"OFFLINE","versions":[{"value":"OFFLINE","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_first_referrer":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_num_event_completions":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"hs_social_google_plus_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"email":{"value":"testingapis@hubspot.com","versions":[{"value":"testingapis@hubspot.com","source-type":"CONTACTS_WEB","source-id":"dadams@hubspot.com","source-label":null,"timestamp":1345062449008,"selected":false}]},"hs_analytics_last_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_num_page_views":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_first_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source_data_2":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source_data_1":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_visit_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]}},"form-submissions":[],"list-memberships":[],"identity-profiles":[{"vid":82325,"identities":[{"type":"EMAIL","value":"testingapis@hubspot.com","timestamp":1345062449327},{"type":"LEAD_GUID","value":"c0da5c41-f289-4642-910c-9aa2b0fba245","timestamp":1345062449333}]}]}'
-    http_version: 
-  recorded_at: Mon, 18 Feb 2013 00:27:11 GMT
-- request:
-    method: get
-    uri: https://api.hubapi.com/contacts/v1/contact/email/notacontact@test.com/profile?hapikey=demo
-    body:
-      encoding: US-ASCII
-      string: ''
-    headers: {}
-  response:
-    status:
-      code: 404
-      message: Not Found
-    headers:
-      Content-Type:
-      - application/json;charset=UTF-8
-      Date:
-      - Mon, 18 Feb 2013 00:27:11 GMT
-      Server:
-      - Apache-Coyote/1.1
-      Content-Length:
-      - '95'
-      Connection:
-      - keep-alive
-    body:
-      encoding: US-ASCII
-      string: ! '{"status":"error","message":"resource not found","guid":"c1ff8266-2bff-4278-9717-d4db2ea429cc"}'
-    http_version: 
-  recorded_at: Mon, 18 Feb 2013 00:27:11 GMT
-recorded_with: VCR 2.4.0

data/spec/fixtures/vcr_cassettes/find_contact_by_id.yml

@@ -1,59 +0,0 @@
----
-http_interactions:
-- request:
-    method: get
-    uri: https://api.hubapi.com/contacts/v1/contact/vid/82325/profile?hapikey=demo
-    body:
-      encoding: US-ASCII
-      string: ''
-    headers: {}
-  response:
-    status:
-      code: 200
-      message: OK
-    headers:
-      Access-Control-Allow-Credentials:
-      - 'false'
-      Content-Type:
-      - application/json;charset=UTF-8
-      Date:
-      - Mon, 18 Feb 2013 00:35:33 GMT
-      Server:
-      - Apache-Coyote/1.1
-      Content-Length:
-      - '4857'
-      Connection:
-      - keep-alive
-    body:
-      encoding: US-ASCII
-      string: ! '{"vid":82325,"canonical-vid":82325,"portal-id":62515,"profile-token":"AO_T-mMbtNq2RnAUjbHWrHMch5z4aOs7MBYrtC9WGDpghGH-X3L3ZuRjqPAj5LhRh5C17U-jCRLDOUi1hcvLdzqFAo1-vyCmW82-pXxzMA2uZpEjXNmn_9duS1o9GryBETCHoMLpzijw","profile-url":"https://app.hubspot.com/contacts/62515/lists/public/contact/_AO_T-mMbtNq2RnAUjbHWrHMch5z4aOs7MBYrtC9WGDpghGH-X3L3ZuRjqPAj5LhRh5C17U-jCRLDOUi1hcvLdzqFAo1-vyCmW82-pXxzMA2uZpEjXNmn_9duS1o9GryBETCHoMLpzijw/","properties":{"hs_analytics_num_visits":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_referrer":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_linkedin_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_url":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_last_engagement":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_social_num_broadcast_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"hs_social_facebook_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"createdate":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"API","source-id":null,"source-label":null,"timestamp":1345062449002,"selected":false}]},"lastname":{"value":"Cunningham","versions":[{"value":"Cunningham","source-type":"API","source-id":null,"source-label":null,"timestamp":1361146313002,"selected":false}]},"hs_social_twitter_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"firstname":{"value":"Steve","versions":[{"value":"Steve","source-type":"API","source-id":null,"source-label":null,"timestamp":1361146313002,"selected":false}]},"hs_analytics_first_url":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source":{"value":"OFFLINE","versions":[{"value":"OFFLINE","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_first_referrer":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_num_event_completions":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"hs_social_google_plus_clicks":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]},"email":{"value":"testingapis@hubspot.com","versions":[{"value":"testingapis@hubspot.com","source-type":"CONTACTS_WEB","source-id":"dadams@hubspot.com","source-label":null,"timestamp":1345062449008,"selected":false}]},"hs_analytics_last_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_num_page_views":{"value":"0","versions":[{"value":"0","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_first_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source_data_2":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_source_data_1":{"value":"","versions":[{"value":"","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1345067864004,"selected":false}]},"hs_analytics_last_visit_timestamp":{"value":"1345062449327","versions":[{"value":"1345062449327","source-type":"ANALYTICS","source-id":null,"source-label":null,"timestamp":1348916431004,"selected":false}]}},"form-submissions":[],"list-memberships":[],"identity-profiles":[{"vid":82325,"identities":[{"type":"EMAIL","value":"testingapis@hubspot.com","timestamp":1345062449327},{"type":"LEAD_GUID","value":"c0da5c41-f289-4642-910c-9aa2b0fba245","timestamp":1345062449333}]}]}'
-    http_version: 
-  recorded_at: Mon, 18 Feb 2013 00:35:33 GMT
-- request:
-    method: get
-    uri: https://api.hubapi.com/contacts/v1/contact/vid/9999999/profile?hapikey=demo
-    body:
-      encoding: US-ASCII
-      string: ''
-    headers: {}
-  response:
-    status:
-      code: 404
-      message: Not Found
-    headers:
-      Content-Type:
-      - application/json;charset=UTF-8
-      Date:
-      - Mon, 18 Feb 2013 00:35:34 GMT
-      Server:
-      - Apache-Coyote/1.1
-      Content-Length:
-      - '95'
-      Connection:
-      - keep-alive
-    body:
-      encoding: US-ASCII
-      string: ! '{"status":"error","message":"resource not found","guid":"4710ce10-c3c7-4f35-ae2c-4c4f182325a6"}'
-    http_version: 
-  recorded_at: Mon, 18 Feb 2013 00:35:34 GMT
-recorded_with: VCR 2.4.0