pjatx/tap-copper

tap-copper

Author: Jacob Werderits (jacob@fishtownanalytics.com)

This is a Singer tap that produces JSON-formatted data following the Singer spec.

It:

• Generates a catalog of available data in Copper
• Extracts the following resources:
  • Accounts
  • Users
  • Leads
  • People
  • Companies
  • Opportunities
  • Activities
  • Projects
  • Tasks
  • Custom Fields

Quick Start

1. Install

git clone git@github.com:fishtown-analytics/tap-copper.git
cd tap-copper
pip install -e .

2. Get an API key

Create a Copper Authentication Token. Tokens are tied to a user's email (the user's permissions determine the data avaialable). After receiving an API token keep it somewhere safe, as you'll need it to authenticate requests. See "Create the config file" below for more information on using this API Token,

3. Create the config file.

There is a template you can use at config.json.example, just copy it to config.json in the repo root and insert your token and email

4. Run the application to generate a catalog.

tap-copper -c config.json --discover > catalog.json

5. Select the tables you'd like to replicate

Step 4 generates a a file called catalog.json that specifies all the available endpoints and fields. You'll need to open the file and select the ones you'd like to replicate. See the Singer guide on Catalog Format for more information on how tables are selected.

6. Run it!

tap-copper -c config.json --catalog catalog.json

Copyright © 2019 Stitch