auth0/auth0-mailchimp-export

Name: auth0-mailchimp-export

Owner: Auth0

Description: Allows Auth0 Customers to synchronize their Auth0 User base (those that have an email) with a MailChimp List

Created: 2016-12-17 03:53:55.0

Updated: 2017-11-15 18:20:17.0

Pushed: 2017-02-15 00:44:27.0

Homepage: null

Size: 14

Language: JavaScript

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Auth0 MailChimp Export

Auth0 Extensions

This extension allows Auth0 Customers to synchronize their Auth0 User base (those that have an email) with a MailChimp List. From within MailChimp, it is then possible to leverage all the benefits of marketing emails, automated messages and targeted campaigns.

More than 14 million people and businesses around the world use MailChimp. The MailChimp features and integrations allow you to send marketing emails, automated messages, and targeted campaigns. And the detailed reports help you keep improving over time.

For further information on MailChimp - please see https://mailchimp.com/about/ This extension was inspired by this mailchimp forum post by Eugenio.

TODO

Review and address the Issues raised as part of code review.

Configure Webtask

If you haven't configured Webtask on your machine run this first:

i -g wt-cli
nit

Requires at least node 4.2.2 - if you're running multiple version of node make sure to load the right version, e.g. “nvm use 4.2.2”

Running locally

To run the sample locally:

  1. Create an application (client) in Auth0
  2. Go to Auth0 API Management and create a Client Grant.

"audience": "https://YOUR_TENANT.auth0.com/api/v2/",
"client_id":"YOUR_CLIENT_ID",
"scope": ["read:users", "read:user_idp_tokens"]

  1. Run npm install
  2. Run
ack && \
erve build/bundle.js --port 3000 --no-merge \
cret AUTH0_DOMAIN="YOUR_TENANT.auth0.com" \
cret AUTH0_CLIENT_ID="YOUR_CLIENT_ID" \
cret AUTH0_CLIENT_SECRET="YOUR_CLIENT_SECRET" \
cret MAILCHIMP_API_KEY="YOUR_MAILCHIMP_API_KEY" \
cret MAILCHIMP_LIST_NAME="YOUR_MAILCHIMP_LIST_NAME" \
cret AUTH0_CONNECTION_NAME="YOUR_AUTH0_CONNECTION_NAME" 

Then, in separate terminal, just curl 0.0.0.0:3000 to execute.

Note: The client and client grant creating will be automatically when deploying though Auth0 Extensions.

Note: For more information about how to get your_tenant_profile, click here.

Deploying to Auth0 Extensions
  1. Go to Auth0 Extensions
  2. Click on + Create Extension
  3. Fill in the textbox with your GitHub repository URL
  4. Click on continue
  5. Finally, click on install
Usage

Go to your mailchimp account and inspect the List (Lists -> List Name). Here you will see a synchronized list of email users that correspond to those defined in your Auth0 Connection (that have email addresses)

You can retrieve your MailChimp API key from (Account -> Extras -> API Keys)

For information on getting started with MailChimp API documentation, please refer to:

MailChimp Documentation

Issue Reporting

If you have found a bug or if you have a feature request, please report them at this repository issues section.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.