sendgrid_webapi 0.0.2 → 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2c4750102028a182ab7e513792ca0f127684c5ce2f59562dbe1997869c7099e9
+  data.tar.gz: 406420e68b953fca19e900acd80ab5914c689941588c4b056239f2f5f64f6971
+SHA512:
+  metadata.gz: d912c4463cb6cf6b77d55444e31302450e395c4b2c0eb14bbd4345b77d83dfbba7b3b5b9b563b0e0fff577a5989a00255c69d731d56c08495bd727eb3f15c358
+  data.tar.gz: 445d7ef45b7cb2b7325405120ef271ab1c6b13d50a902e83c63e5bebe16f95889c722f06555adedabb08ba4e70eb652eeec810a6a29f4d285dea64ec51def652

data/.circleci/config.yml

@@ -0,0 +1,132 @@
+# Ruby CircleCI 2.0 configuration file
+#
+# Check https://circleci.com/docs/2.0/language-ruby/ for more details
+#
+defaults: &defaults
+  working_directory: ~/repo
+  docker:
+    - image: circleci/ruby:2.3.6-stretch-node
+      environment:
+        # - DBHOST: localhost
+        # - DBNAME: sendgrid_webapi_test
+        # - DBPASSWORD: Vdm9omJt8Z3MCV4N
+        # - DBUSER: test_user
+        - RACK_ENV: test
+        - RAILS_ENV: test
+    # - image: circleci/postgres:10.3-alpine-ram
+    #   environment:
+    #     - POSTGRES_DB: sendgrid_webapi_test
+    #     - POSTGRES_USER: test_user
+    #     - POSTGRES_PASSWORD: Vdm9omJt8Z3MCV4N
+
+version: 2
+jobs:
+  run_specs:
+    <<: *defaults
+
+    steps:
+      - run:
+          name: Set up environment
+          command: |
+            sudo apt-get update && sudo apt-get install -y apt-transport-https apt-utils
+
+      - checkout
+
+      - restore_cache:
+          keys:
+          - sendgrid_webapi-dependencies-v1-{{ checksum "sendgrid_webapi.gemspec" }}
+          - sendgrid_webapi-dependencies-v1-
+
+      - run:
+          name: Install dependencies
+          command: |
+            # curl -sS https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
+            # echo "deb http://apt.postgresql.org/pub/repos/apt/ stretch-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list
+            # sudo apt-get update && sudo apt-get install postgresql-client-10
+            bundle check --path=./vendor/bundle || bundle install --path=./vendor/bundle --jobs=4 --retry=3
+
+      - save_cache:
+          key: sendgrid_webapi-dependencies-v1-{{ checksum "sendgrid_webapi.gemspec" }}
+          paths:
+            - ./vendor/bundle
+
+      # - run:
+      #     name: Set up database
+      #     command: |
+      #       cp spec/internal/config/database.docker.yml spec/internal/config/database.yml
+
+      - run:
+          name: Run tests
+          command: |
+            mkdir /tmp/test-results
+            TEST_FILES="$(circleci tests glob "spec/**/*_spec.rb" | circleci tests split --split-by=timings)"
+            bundle exec rspec --format progress --format RspecJunitFormatter --out /tmp/test-results/rspec.xml $TEST_FILES
+
+      - store_test_results:
+          path: /tmp/test-results
+
+      - store_artifacts:
+          path: /tmp/test-results
+          destination: test-results
+
+  build_gem:
+    <<: *defaults
+
+    steps:
+      - run:
+          name: Set up environment
+          command: |
+            sudo apt-get update && sudo apt-get install -y apt-transport-https apt-utils
+
+      - checkout
+
+      - restore_cache:
+          keys:
+          - sendgrid_webapi-dependencies-v1-{{ checksum "sendgrid_webapi.gemspec" }}
+          - sendgrid_webapi-dependencies-v1-
+
+      - run:
+          name: Install dependencies
+          command: |
+            gem install gemfury
+            bundle check --path=./vendor/bundle || bundle install --path=./vendor/bundle --jobs=4 --retry=3
+
+      - save_cache:
+          key: sendgrid_webapi-dependencies-v1-{{ checksum "sendgrid_webapi.gemspec" }}
+          paths:
+            - ./vendor/bundle
+
+      - run:
+          name: Build gem
+          command: |
+            gem build sendgrid_webapi.gemspec
+
+      - run:
+          name: Push gem
+          command: |
+            if [[ "${CIRCLE_PROJECT_USERNAME}" == "OneHQ" && "${CIRCLE_BRANCH}" == "master" && -n "${RUBYGEMS_API_KEY}" ]]; then
+              bash .circleci/setup-rubygems.sh
+              version=$(ruby -e 'load "lib/version.rb"; puts SendGridWebApi::VERSION')
+              grep -q "${version}" <(gem search sendgrid_api) || EXIT_CODE=$? && true
+              if [[ $EXIT_CODE == 1 ]]; then
+                gem push sendgrid_webapi-${version}.gem
+                git tag ${version}
+                git push --tags
+
+                [[ -n "$SLACK_TOKEN" ]] && curl -s -d "sendgrid_webapi ($version) released." "https://onehq.slack.com/services/hooks/slackbot?token=${SLACK_TOKEN}&channel=%23machines"
+              fi
+            fi
+
+workflows:
+  version: 2
+  build-deploy:
+    jobs:
+      - run_specs
+      - build_gem:
+          requires:
+            - run_specs
+          filters:
+            branches:
+              only:
+                - master
+                - staging

data/.circleci/setup-rubygems.sh

@@ -0,0 +1,5 @@
+#!/bin/sh
+
+mkdir -p ~/.gem
+echo -e "---\r\n:rubygems_api_key: $RUBYGEMS_API_KEY" > ~/.gem/credentials
+chmod 0600 /home/circleci/.gem/credentials

data/.gitignore

@@ -1,5 +1,31 @@
 *.gem
+*.pgz
+*.tmproj
 .bundle
+.DS_Store
+.gitconfig
+.idea
 .rvmrc
+.sass-cache
+/.ey_local_data
+/.ruby-gemset
+/.vagrant
+bin/*
+config/*.sphinx.conf
+config/database.yml
+config/sphinx.yml
+db/sphinx/
+Gemfile.lock
+log
+log/*.log
+project.rvmrc
+public/assets
+public/flash/*.swf
+public/javascripts/packaged/*.js
+public/packages/*
+public/stylesheets/packaged/*.css
+spec/internal/config/database.yml
+sphinx/**/*
+tmp
+tmp/**/*
 Gemfile.lock
-pkg/*

data/.rspec

@@ -1,2 +1,2 @@
---colour
---format nested
+--color
+--require spec_helper

data/.ruby-version

@@ -0,0 +1 @@
+3.0.0

data/.tool-versions

@@ -0,0 +1 @@
+ruby 2.3.6

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2021 Kyle Ginavan
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -1,4 +1,5 @@
-= SendGrid WEB API gem for Rails 3 {<img src="https://secure.travis-ci.org/kylejginavan/sendgrid_webapi.png"/>}[http://travis-ci.org/kylejginavan/sendgrid_webapi]
+= SendGrid WEB API gem for Rails 3
+{<img src="https://secure.travis-ci.org/kylejginavan/sendgrid_webapi.png"/>}[http://travis-ci.org/kylejginavan/sendgrid_webapi] {<img src="https://badge.fury.io/rb/sendgrid_webapi.png" alt="Gem Version" />}[http://badge.fury.io/rb/sendgrid_webapi] {<img src="https://codeclimate.com/github/kylejginavan/sendgrid_webapi.png" />}[https://codeclimate.com/github/kylejginavan/sendgrid_webapi]
 
 SendGrid WEB API gem allow you to retrieve information such as statistics, bounces, spam reports, unsubscribes, send email and other information.
 
@@ -6,13 +7,19 @@ SendGrid WEB API gem allow you to retrieve information such as statistics, bounc
 
 In your Gemfile:
 
-    gem 'sendgrid_webapi'
+for sendgrid v3 support
+
+    gem 'sendgrid_webapi', '0.0.3'
+
+for sendgrid v2 support
+
+    gem 'sendgrid_webapi', '0.0.2'
 
 == Usage examples
 
 === Creating client object:
 
-    client = SendGridWebApi::Client.new("user_name", "password")
+    client = SendGridWebApi::Client.new("apikey")
 
 == Modules
 
@@ -23,7 +30,9 @@ This module allows you to retrieve and delete email addresses that have bounced
 
     client.bounces.delete(:email => "email@example.com", :foor => "bar")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/web-api/webapibounces
+    client.blocks.count
+
+* options are available here: http://sendgrid.com/docs/API_Reference/Web_API/bounces.html
 
 === Blocks
 This module allows you to retrieve and delete email addresses that were blocked by their ISP. These emails are not suppressed and are just for information.
@@ -32,7 +41,9 @@ This module allows you to retrieve and delete email addresses that were blocked
 
     client.blocks.delete(:email => "email@example.com", :foor => "bar")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/web-api/webapiblocks
+    client.blocks.count
+
+* options are available here: http://sendgrid.com/docs/API_Reference/Web_API/blocks.html
 
 === Invalid Email
 This module allows you to retrieve and delete email addresses that you've sent to that are invalid email addresses.
@@ -41,7 +52,7 @@ This module allows you to retrieve and delete email addresses that you've sent t
 
     client.invalid_emails.delete(:email => "email@example.com", :foor => "bar")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/web-api/webapiinvalidemails
+* options are available here: http://sendgrid.com/docs/API_Reference/Web_API/invalid_emails.html
 
 === Spam Report
 This module allows you to retrieve and delete email addresses that have marked your emails as SPAM.
@@ -50,7 +61,7 @@ This module allows you to retrieve and delete email addresses that have marked y
 
     client.spam.delete(:email => "email@example.com", :foor => "bar")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/web-api/webapispamreports
+* options are available here: http://sendgrid.com/docs/API_Reference/Web_API/spam_reports.html
 
 === Unsubscribes
 This module allows you to add, retrieve and delete email addresses that were unsubscribed from your emails.
@@ -61,18 +72,18 @@ This module allows you to add, retrieve and delete email addresses that were uns
 
     client.unsubscribes.delete(:email => "email@example.com", :foor => "bar")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/web-api/webapiunsubscribes
+* options are available here: http://sendgrid.com/docs/API_Reference/Web_API/unsubscribes.html
 
 === Parse Email
 This module allows you to add, edit, or delete your email parse settings.
 
-    client.parse_emails.add(:hostname => "www.example.com", :url => "www.domain.com/parse.php", :spam_check => 1)
+    client.parse_email.add(:hostname => "www.example.com", :url => "www.domain.com/parse.php", :spam_check => 1)
 
-    client.parse_emails.get(options)
+    client.parse_email.get(options)
 
-    client.parse_emails.delete(:hostname => "www.example.com")
+    client.parse_email.delete(:hostname => "www.example.com")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/web-api/webapiparse
+* options are available here: http://sendgrid.com/docs/API_Reference/Web_API/parse_settings.html
 
 === Event Notification URL
 This module allows you to add, edit, or delete an event notification URL for your account.
@@ -83,7 +94,7 @@ This module allows you to add, edit, or delete an event notification URL for you
 
     client.event_notification.delete(options)
 
-* options are available here: http://docs.sendgrid.com/documentation/api/web-api/event-notification-url
+* options are available here: http://sendgrid.com/docs/API_Reference/Webhooks/event.html
 
 
 === Stats
@@ -91,36 +102,36 @@ This module allows you to retrieve statistical data on a range of metrics includ
 
     client.stats.get(options)
 
-* options are available here: http://docs.sendgrid.com/documentation/api/web-api/event-notification-url
+* options are available here: http://sendgrid.com/docs/API_Reference/Web_API/Statistics/index.html
 
 === Profile
 This module allows you to retrieve and update your profile information such as credentials and email address.
 
     client.profile.get(options)
-    
+
     client.profile.set(options)
-    
+
     client.profile.set_password(:password => "foo", :confirm_password => "foo")
 
     client.profile.set_username(:username => "yournewusername@domain.com")
-    
+
     client.profile.set_email(:email => "yournewusername@domain.com")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/web-api/webapiprofile
+* options are available here: http://sendgrid.com/docs/API_Reference/Web_API/profile.html
 
 
 === Mail
 This module allows you to send email.
-  
+
   client.mail.send(:to => "test@test.com", :subject => "test", :text => "some body", :from => "test@example.com")
-  
-* options are available here: http://docs.sendgrid.com/documentation/api/web-api/mail/
+
+* options are available here: http://sendgrid.com/docs/Code_Examples/ruby.html
 
 == SubUser
 
 === Creating client object:
 
-    client = SendGridWebApi::Client.new("user_name", "password")
+    client = SendGridWebApi::Client.new("apikey")
 
     client.sub_user
 
@@ -128,7 +139,7 @@ This module allows you to send email.
 == Modules
 
 === Management SubUsers
-Retrieve/Create/Enable/Disable your subusers. Change a subuser email address and username.
+Retrieve/Create/Enable/Disable your subusers. Change a subuser email address and username. Docs can be found here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/index.html
 
 Create a sub_user
 
@@ -157,14 +168,14 @@ Disable a subuser to login to the SendGrid.com website
 Allows you to update your subusers profile information
 
     client.sub_user.management.update(:user => "sub_user", :first_name => "change_named")
-  
+
     client.sub_user.management.update_password(:user => "sub_user", :password => "somepassword", :confirm_password => "somepassword")
 
     client.sub_user.management.update_username(:user => "sub_user", :username => "newusername")
-  
+
     client.sub_user.management.update_email(:user => "sub_user", :email => "newemail")
-  
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-api/subusers/  
+
+* options are available here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/subusers.html
 
 === Bounces
 This module allows you to manage bounce records of your subusers.
@@ -173,7 +184,7 @@ This module allows you to manage bounce records of your subusers.
 
     client.sub_user.bounces.delete(:user => "sub_user", :email => "email@example.com")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-subuser-api-v1/email-list-management/subuser-bounces/
+* options are available here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/subuser_bounces.html
 
 === Invalid Email
 This module allows you to manage invalid emails of your subusers.
@@ -182,7 +193,7 @@ This module allows you to manage invalid emails of your subusers.
 
     client.sub_user.invalid_emails.delete(:user => "sub_user", :email => "email@example.com")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-api/subuser-invalid-emails/
+* options are available here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/invalid_emails.html
 
 === Spam Report
 This module allows you to manage spam reports of your subusers.
@@ -191,7 +202,7 @@ This module allows you to manage spam reports of your subusers.
 
     client.sub_user.spam.delete(:user => "sub_user", :email => "email@example.com")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-subuser-api-v1/email-list-management/subuser-spam-reports/
+* options are available here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/subuser_spam_reports.html
 
 === Unsubscribes
 This module allows you to manage unsubscribes of your subusers.
@@ -202,18 +213,18 @@ This module allows you to manage unsubscribes of your subusers.
 
     client.sub_user.unsubscribes.delete(:user => "sub_user", :email => "email@example.com")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-subuser-api-v1/email-list-management/subusers-unsubscribes/
+* options are available here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/subuser_unsubscribes.html
 
 === Parse Email
 This module allows you to setup subusers parse settings
 
-    client.sub_user.parse_emails.add(:user => "sub_user", :hostname => "www.example.com", :url => "www.domain.com/parse.php", :spam_check => 1)
+    client.sub_user.parse_email.add(:user => "sub_user", :hostname => "www.example.com", :url => "www.domain.com/parse.php", :spam_check => 1)
 
-    client.sub_user.parse_emails.get(:user => "sub_user")
+    client.sub_user.parse_email.get(:user => "sub_user")
 
-    client.sub_user.parse_emails.delete(:user => "sub_user", :hostname => "www.example.com")
+    client.sub_user.parse_email.delete(:user => "sub_user", :hostname => "www.example.com")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-api/parse-settings/
+* options are available here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/parse_settings.html
 
 === Event Notification URL
 This module allows you to manage subusers event notification url.
@@ -224,7 +235,7 @@ This module allows you to manage subusers event notification url.
 
     client.sub_user.event_notification.delete(:user => "sub_user", :url => "http://www.yourposturlhere.com")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-api/event-notification-url/
+* options are available here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/event_notification_url.html
 
 
 === Stats
@@ -232,38 +243,38 @@ This module allows you to see statistics regarding your subusers.
 
     client.sub_user.stats.get(:user => "sub_user")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-api/statistics/
+* options are available here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/statistics.html
 
 === Limits
 This module allows you to manage the rate of emails your subusers are able to send
 
     client.sub_user.limits.get(:user => "sub_user")
-    
+
     client.sub_user.limits.set_credits(:user => "sub_user", :credits=> "200", :period=> "daily")
-    
+
     client.sub_user.limits.reset(:user => "sub_user", :credits=> "400", :period=> "daily")
-    
+
     client.sub_user.limits.increment_credits(:user => "sub_user", :credits=> "400")
-    
+
     client.sub_user.limits.decrement_credits(:user => "sub_user", :credits=> "400")
 
 To remove all limits from your sub_user
 
     client.sub_user.limits.delete(:user => "sub_user")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-api/account-limits/
+* options are available here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/account_limits.html
 
 
 === Monitor Records
 Make sure your subusers arent sending out spam by getting a sample of their outgoing messages
 
     client.sub_user.monitor_records.create(:name => "testmonitor", :frequency => 10000, :email => "test@test.com")
-    
+
     client.sub_user.monitor_records.edit(:name => "testmonitor", :new_frequency => 10)
-    
+
     client.sub_user.monitor_records.add_user(:user => "sub_user", :name => "testmonitor")
-    
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-api/monitor-records/
+
+* options are available here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/monitor_records.html
 
 === IP Management
 List all IP addresses you have under your account and retrieve details about them
@@ -273,14 +284,14 @@ To obtain a complete list of all IP's and which are free, taken or available. Se
     client.sub_user.ip_management.get(:user => "sub_user")
 
 To get the ip that is using your sub_user
-  
+
     client.sub_user.ip_management.usage_ip(:user => "sub_user")
-    
-To assign one ip to your sub_user    
-  
+
+To assign one ip to your sub_user
+
     client.sub_user.ip_management.assign_ip(:user => "sub_user", :ip => ["IP1", "IP2"])
 
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-api/ip-management/
+* options are available here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/ip_management.html
 
 === WhiteLabel
 Manage whitelabel settings for your subusers
@@ -294,52 +305,65 @@ To set a subusers whitelabel domain
     client.sub_user.whitelabel.add(:user => "sub_user", :mail_domain => "email.sendgrid.com")
 
 
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-api/whitelabel/
-    
+* options are available here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/whitelabel.html
+
 
 === IFrame
 Allow users to manage your subusers via iframe using our site
 
     client.sub_user.iframe.get(:user => "sub_user")
 
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-api/automatic-login/
-
-
-=== Parse Email
-This module allows you to setup subusers parse settings.
-
-    client.sub_user.parse_emails.add(:user => "sub_user", :hostname => "www.example.com", :url => "www.domain.com/parse.php", :spam_check => 1)
-
-    client.sub_user.parse_emails.get(:user => "sub_user")
-
-    client.sub_user.parse_emails.delete(:user => "sub_user", :hostname => "www.example.com")
-
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-api/parse-settings/
+* options are available here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/automatic_login.html
 
 
 === Authentication
 This module allows you to check subusers password to see if its valid.
 
     client.sub_user.auth.login(:user => "sub_user", :password => "somepass").
-    
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-api/authenticate-a-subuser/
+
+* options are available here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/authenticate_a_subuser.html
 
 
 === Apps
 This module allows you to setup subusers app settings.
 
     client.sub_user.apps.list(:user => "sub_user")
-    
+
     client.sub_user.apps.activate(:user => "sub_user", :name => "opentrack")
 
     client.sub_user.apps.deactivate(:user => "sub_user", :name => "opentrack")
-    
+
     client.sub_user.apps.current_settings(:user => "sub_user", :name => "eventnotify")
-    
-    client.sub_user.apps.customize(:user => "sub_user", :name => "eventnotify", :processed => "0", :dropped => "1", :deferred => "1", :delivered => "0", :bounce => "1", :click => "1", :open => "1", :unsubscribe => "1", :spamreport => "1", :url => "http://someurl.com/listener"))    
-    
-* options are available here: http://docs.sendgrid.com/documentation/api/customer-subuser-api/customer-api/filter-apps/
 
+    client.sub_user.apps.customize(:user => "sub_user", :name => "eventnotify", :processed => "0", :dropped => "1", :deferred => "1", :delivered => "0", :bounce => "1", :click => "1", :open => "1", :unsubscribe => "1", :spamreport => "1", :url => "http://someurl.com/listener"))
+
+* options are available here: http://sendgrid.com/docs/API_Reference/Customer_Subuser_API/apps.html
+
+
+=== Apikey
+This module allows you to manage apikeys
+
+    client.apikey.management.get
+
+    client.apikey.management.get({ on_behalf_of: "SUB_USERNAME" })
+
+    client.apikey.management.get({ apikey_id: "APIKEY_ID" })
+
+    client.apikey.management.get({ on_behalf_of: "SUB_USERNAME" })
+
+    client.apikey.management.create({ "name" => "APIKEY NAME", "scopes" => ["mail.send"] })
+
+    client.apikey.management.create({ on_behalf_of: "SUB_USERNAME", "name" => "APIKEY NAME", "scopes" => ["mail.send"] })
+
+    client.apikey.management.update("APIKEY_ID", { "name" => "NEW APIKEY NAME"})
+
+    client.apikey.management.update("APIKEY_ID", { on_behalf_of: "SUB_USERNAME", "name" => "NEW APIKEY NAME"})
+
+    client.apikey.management.delete("APIKEY_ID")
+
+    client.apikey.management.delete("APIKEY_ID", { on_behalf_of: "SUB_USERNAME" })
+
+* options are available here: https://sendgrid.com/docs/api-reference/
 
 == Helper
 
@@ -351,18 +375,18 @@ define the data
     user_hash = {:website => "someurl.com", :password => "somepass", :confirm_password => "somepass",
                :first_name => "home", :last_name => "simpson", :address => "555 anystreet", :city =>  "any city",
                :state => "CA" , :zip => "91234", :email => "email@email.com", :country => "US", :phone => "555-555"}
-  
+
     apps = { :opentrack => {:name => "eventnotify", :processed => "0", :dropped => "1", :deferred => "1",
-                          :delivered => "0", :bounce => "1", :click => "1", :open => "1", :unsubscribe => "1", :spamreport => "1", 
+                          :delivered => "0", :bounce => "1", :click => "1", :open => "1", :unsubscribe => "1", :spamreport => "1",
                           :url => "https://agencieshq.com/sendgrid/v1/listener"},
            :clicktrack => {:enable_text => "1"},
            :opentrack => {}
     }
 
     users = {"username" => {:account => user_hash, :applications => apps, :assigned_ips => ["IP"]}}
-    
+
 call the helper
-    
+
     create_sub_user_account("sendgrid user", "sendgrid pass", users)
 
 === Run SendGrid Query
@@ -386,4 +410,4 @@ The API call was unsuccessful. The gem will return ApiException raise.
 == CONTRIBUTORS:
 
 * Kyle J. Ginavan.
-* Mauro Torres - http://github.com/chebyte
+* Mauro Torres - http://github.com/chebyte