Contactually-Ruby

This is a simple API Wrapper for the Contactually API. It is not feature complete, as it does not support all available API endpoints yet, but should work for most use cases this will be fine. Feel free to contribute!

Add this line to your application's Gemfile:

gem 'contactually-ruby'

And then execute:

$ bundle

Or install it yourself as:

$ gem install contactually-ruby

As contactually-ruby is shipped with sensible defaults, that will allow you to start right away, there are a couple of settings you may want to adjust, depending on your applications requirements.

The available configuration options are:

• access_token (your contactually access_token)
• contactually_url (Default: "https://api.contactually.com/v2/")

1. Register a new app. Permission scopes are here all:manage is full access

2. put in a junk (but valid) url in the redirect URL - aka https://test.my-app-url-is-fake.com

3. click the 'authorize' link under the callback url - copy the code in the URL string you'll also need the application id & secret from your application page you just created

4. curl -H "Content-Type: application/json" -X POST -d '{"grant_type": "authorization_code", "client_id": "your_application_id", "client_secret": "secret_from_application_page", "code": "code_from_auth_url", "redirect_uri": "your_callback_url"}' https://auth.contactually.com/oauth2/token

5. The response to that (assuming you did it all correctly) will be your access_token

Configuration goes as follows:

    Contactually.configure do |c|
      c.access_token         = "TOKEN FROM OAUTH"
    end

    contactually = Contactually::API.new
    contacts = contactually.contacts.index
    # => [#<Contactually::Contact id=1234, ...>, #<Contactually::Contact id=1235, ...>, ...]
    notes = contactually.notes.index
    # => [#<Contactually::Note id=2345, ...>, #<Contactually::Note id=2346, ...>, ...]
    groupings = contactually.groupings.index
    # => [#<Contactually::Grouping id=3456, ...>, #<Contactually::Grouping id=3457, ...>, ...]

    contact = { contact: { first_name: 'Jane', last_name: 'Doe', ... } }
    contactually.contacts.create(contact)
    # => #<Contactually::Contact id=9876, first_name='Jane', last_name='Doe', ...>

Implemented endpoints are:

• Accounts
• Buckets
• Contact Groupings
• Contacts
• Contents
• Groupings
• Interactions
• Notes
• Tasks

The API is documented here: Contactually API Docs

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request