|
1 |
| -# auth-mailchimp-sync |
| 1 | +# Sync with Mailchimp |
2 | 2 |
|
3 |
| -**VERSION**: 0.1.0 |
| 3 | +**Description**: Adds new users from Firebase Authentication to a specified Mailchimp audience. |
4 | 4 |
|
5 |
| -**DESCRIPTION**: Adds new users from Firebase Authentication to a specified Mailchimp audience. |
6 | 5 |
|
7 | 6 |
|
| 7 | +**Details**: Use this extension to add new users to an existing [Mailchimp](https://mailchimp.com) audience. |
8 | 8 |
|
9 |
| -**CONFIGURATION PARAMETERS:** |
| 9 | +This extension adds the email address of each new user to your specified Mailchimp audience. Also, if the user deletes their user account for your app, this extension removes the user from the Mailchimp audience. |
10 | 10 |
|
11 |
| -* Deployment location: Where should the extension be deployed? For help selecting a location, refer to the [location selection guide](https://firebase.google.com/docs/functions/locations). |
| 11 | +**Note:** To use this extension, you need to manage your users with Firebase Authentication. |
12 | 12 |
|
13 |
| -* Mailchimp API key: What is your Mailchimp API key? To obtain a Mailchimp API key, go to your [Mailchimp account](https://admin.mailchimp.com/account/api/). |
| 13 | +This extension uses Mailchimp, so you'll need to supply your Mailchimp API Key and Audience ID when installing this extension. |
14 | 14 |
|
15 |
| -* Audience ID: What is the Mailchimp Audience ID to which you want to subscribe new users? To find your Audience ID: visit https://admin.mailchimp.com/lists, click on the desired audience or create a new audience, then select **Settings**. Look for **Audience ID** (for example, `27735fc60a`). |
| 15 | +#### Additional setup |
16 | 16 |
|
17 |
| -* Contact status: When the extension adds a new user to the Mailchimp audience, what is their initial status? This value can be `subscribed` or `pending`. `subscribed` means the user can receive campaigns; `pending` means the user still needs to opt-in to receive campaigns. |
| 17 | +Make sure that you've set up [Firebase Authentication](https://firebase.google.com/docs/auth) to manage your users. |
18 | 18 |
|
| 19 | +You must also have a Mailchimp account before installing this extension. |
19 | 20 |
|
| 21 | +#### Billing |
20 | 22 |
|
21 |
| -**CLOUD FUNCTIONS CREATED:** |
| 23 | +This extension uses other Firebase or Google Cloud Platform services which may have associated charges: |
22 | 24 |
|
23 |
| -* addUserToList (providers/firebase.auth/eventTypes/user.create) |
| 25 | +- Firebase Realtime Database |
| 26 | +- Cloud Functions |
24 | 27 |
|
25 |
| -* removeUserFromList (providers/firebase.auth/eventTypes/user.delete) |
| 28 | +When you use Firebase Extensions, you're only charged for the underlying resources that you use. A paid-tier billing plan is only required if the extension uses a service that requires a paid-tier plan, for example calling to a Google Cloud Platform API or making outbound network requests to non-Google services. All Firebase services offer a free tier of usage. [Learn more about Firebase billing.](https://firebase.google.com/pricing) |
26 | 29 |
|
| 30 | +Usage of this extension also requires you to have a Mailchimp account. You are responsible for any associated costs with your usage of Mailchimp. |
27 | 31 |
|
28 | 32 |
|
29 |
| -**DETAILS**: Use this extension to add new users to an existing [Mailchimp](https://mailchimp.com) audience. |
30 | 33 |
|
31 |
| -This extension adds the email address of each new user to your specified Mailchimp audience. Also, if the user deletes their user account for your app, this extension removes the user from the Mailchimp audience. |
32 | 34 |
|
33 |
| -**Note:** To use this extension, you need to manage your users with Firebase Authentication. |
34 | 35 |
|
35 |
| -This extension uses Mailchimp, so you'll need to supply your Mailchimp API Key and Audience ID when installing this extension. |
| 36 | +**Configuration Parameters:** |
36 | 37 |
|
37 |
| -#### Additional setup |
| 38 | +* Deployment location: Where should the extension be deployed? For help selecting a location, refer to the [location selection guide](https://firebase.google.com/docs/functions/locations). |
38 | 39 |
|
39 |
| -Make sure that you've set up [Firebase Authentication](https://firebase.google.com/docs/auth) to manage your users. |
| 40 | +* Mailchimp API key: What is your Mailchimp API key? To obtain a Mailchimp API key, go to your [Mailchimp account](https://admin.mailchimp.com/account/api/). |
40 | 41 |
|
41 |
| -You must also have a Mailchimp account before installing this extension. |
| 42 | +* Audience ID: What is the Mailchimp Audience ID to which you want to subscribe new users? To find your Audience ID: visit https://admin.mailchimp.com/lists, click on the desired audience or create a new audience, then select **Settings**. Look for **Audience ID** (for example, `27735fc60a`). |
42 | 43 |
|
43 |
| -#### Billing |
| 44 | +* Contact status: When the extension adds a new user to the Mailchimp audience, what is their initial status? This value can be `subscribed` or `pending`. `subscribed` means the user can receive campaigns; `pending` means the user still needs to opt-in to receive campaigns. |
44 | 45 |
|
45 |
| -This extension uses other Firebase or Google Cloud Platform services which may have associated charges: |
46 | 46 |
|
47 |
| -- Firebase Realtime Database |
48 |
| -- Cloud Functions |
49 | 47 |
|
50 |
| -When you use Firebase Extensions, you're only charged for the underlying resources that you use. A paid-tier billing plan is only required if the extension uses a service that requires a paid-tier plan, for example calling to a Google Cloud Platform API or making outbound network requests to non-Google services. All Firebase services offer a free tier of usage. [Learn more about Firebase billing.](https://firebase.google.com/pricing) |
| 48 | +**Cloud Functions:** |
51 | 49 |
|
52 |
| -Usage of this extension also requires you to have a Mailchimp account. You are responsible for any associated costs with your usage of Mailchimp. |
| 50 | +* **addUserToList:** Listens for new user accounts (as managed by Firebase Authentication), then automatically adds the new user to your specified MailChimp audience. |
| 51 | + |
| 52 | +* **removeUserFromList:** Listens for existing user accounts to be deleted (as managed by Firebase Authentication), then automatically removes them from your specified MailChimp audience. |
0 commit comments