> For the complete documentation index, see [llms.txt](https://docs.growsurf.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.growsurf.com/integrations/aweber.md).

# AWeber

Update/add AWeber subscribers with their unique share link and referrer information.

## Sync with your AWeber List

**Step 1:** In *Program Editor > 4. Options > Integrations*, click the *Connect to AWeber* button.

{% hint style="info" %}
Connect AWeber before importing participants. If participants are already in your program, follow [these ESP sync options](https://support.growsurf.com/article/385-how-can-i-sync-my-growsurf-participants-to-my-esp) to send their GrowSurf data to AWeber.
{% endhint %}

![](https://2794996218-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LeklWo0yn03AhWro2Ux%2F-MUw-GYLRkwnxRIhkTLm%2F-MUw1EpTune7TN_j2l2h%2FScreen%20Shot%202021-03-04%20at%203.57.32%20AM.png?alt=media\&token=a4e1d110-5274-4ab6-847b-ac66b7d61ca3)

**Step 2:** Log in to AWeber

![](https://2794996218-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LeklWo0yn03AhWro2Ux%2F-MUw-GYLRkwnxRIhkTLm%2F-MUw1sndmflUwh--hZU1%2FScreen%20Shot%202021-03-04%20at%204.01.47%20AM.png?alt=media\&token=6161dd69-2d9e-4b53-985d-1f5916f99d92)

![](https://2794996218-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LeklWo0yn03AhWro2Ux%2F-MUxyDKGA6tuIOMuZNlj%2F-MUxyTXvJ95MPKnhGnRb%2FScreen%20Shot%202021-03-04%20at%201.00.54%20PM.png?alt=media\&token=ffb99231-c61c-4c13-8125-4181288dc51a)

**Step 3:** Once connected, select an AWeber account and then select an AWeber list that you want to automatically sync to. GrowSurf will add/update your AWeber subscribers every time a new participant is added or referred to your referral or affiliate program.

## Examples

[View our AWeber tutorials](https://docs.growsurf.com/additional-integrations/aweber/tutorials) to see different kinds of examples that you can copy/paste into your email templates.

## **Custom Fields** <a href="#subscriber-fields" id="subscriber-fields"></a>

GrowSurf will automatically create these new subscriber fields for your AWeber lists.

{% hint style="danger" %}
AWeber allows up to 25 custom fields per list. Deleting a field deletes its data for every subscriber.
{% endhint %}

{% hint style="danger" %}
AWeber does not allow custom fields with the word "name" or "email". Because of this restriction, GrowSurf has shortened "name" to "n" and "email" to "e" within various custom fields. See the list below for more details.
{% endhint %}

| **Field Name**                           | **Variables**                                  | **Type** | **Description**                                                                                                                                                                                           | **Example**                                                |
| ---------------------------------------- | ---------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| **GrowSurf Share URL**                   | {!custom GrowSurf Share URL}                   | TEXT     | The participant's unique referral link                                                                                                                                                                    | <https://growsurf.com?grsf=absc123>                        |
| **GrowSurf Participant ID**              | {!custom GrowSurf Participant ID}              | TEXT     | The participant's unique GrowSurf ID                                                                                                                                                                      | abc123                                                     |
| **GrowSurf Referral Status**             | {!custom GrowSurf Referral Status}             | TEXT     | The referral status of the participant\*                                                                                                                                                                  | CREDIT\_PENDING                                            |
| **GrowSurf Participant First N**         | {!custom GrowSurf Participant First N}         | TEXT     | The participant's first name                                                                                                                                                                              | Bob                                                        |
| **GrowSurf Participant Last N**          | {!custom GrowSurf Participant Last N}          | TEXT     | The participant's last name                                                                                                                                                                               | Loblaw                                                     |
| **GrowSurf Referrer First N**            | {!custom GrowSurf Referrer First N}            | TEXT     | The first name of the participant's referrer (if applicable)                                                                                                                                              | Gavin                                                      |
| **GrowSurf Referrer Last N**             | {!custom GrowSurf Referrer Last N}             | TEXT     | The last name of the participant's referrer (if applicable)                                                                                                                                               | Belson                                                     |
| **GrowSurf Referrer E**                  | {!custom GrowSurf Referrer E}                  | TEXT     | The email address of the participant's referrer (if applicable)                                                                                                                                           | <gavin.belson@hoolie.io>                                   |
| **GrowSurf Total Referral Count**        | {!custom GrowSurf Total Referral Count}        | NUMBER   | The participant's all-time referral count                                                                                                                                                                 | 0                                                          |
| **GrowSurf Lead Count**                  | {!custom GrowSurf Lead Count}                  | NUMBER   | The participant's current lead count (pending referrals that have not converted yet)                                                                                                                      | 0                                                          |
| **GrowSurf Monthly Referral Count**      | {!custom GrowSurf Monthly Referral Count}      | NUMBER   | The participant's current month referral count                                                                                                                                                            | 19                                                         |
| **GrowSurf Prev Monthly Referral Count** | {!custom GrowSurf Prev Monthly Referral Count} | NUMBER   | The participant's previous month referral count                                                                                                                                                           | 200                                                        |
| **GrowSurf Next Milestone**              | {!custom GrowSurf Next Milestone}              | TEXT     | The text for the next/upcoming milestone reward (only applies to milestone rewards. [See an example here](https://docs.growsurf.com/developer-tools/embeddable-elements#embedded-next-milestone))         | You are only 2 referrals away from winning a free t-shirt! |
| **GrowSurf Next Monthly Milestone**      | {!custom GrowSurf Next Monthly Milestone}      | TEXT     | The text for the next/upcoming monthly milestone reward (only applies to milestone rewards. [See an example here](https://docs.growsurf.com/developer-tools/embeddable-elements#embedded-next-milestone)) | You are only 2 referrals away from winning a free t-shirt! |
| **GrowSurf Total Invite Count**          | {!custom GrowSurf Total Invite Count}          | NUMBER   | The participant's all-time invite count                                                                                                                                                                   | 112                                                        |
| **GrowSurf Total Impression Count**      | {!custom GrowSurf Total Impression Count}      | NUMBER   | The participant's all-time impression count                                                                                                                                                               | 150                                                        |
| **GrowSurf Language**                    | {!custom GrowSurf Language}                    | TEXT     | The participant's program language (ISO code such as es or pt-BR)                                                                                                                                         | es                                                         |

\**GrowSurf Referral Status* can have one of these values:

* `CREDIT_PENDING`: The participant must trigger a referral before their referrer receives credit.
* `CREDIT_AWARDED`: The participant triggered a referral, and their referrer received credit.
* `CREDIT_EXPIRED`: The participant did not trigger a referral before the referral credit expired.

You can use these new subscriber fields in your AWeber email templates. For example, use `{{ subscriber.custom_field['growsurf_share_url'] }}` to add each participant's unique referral link.

## **Troubleshooting Tips** <a href="#troubleshooting-tips" id="troubleshooting-tips"></a>

* Check the participant's activity logs if they do not sync. GrowSurf retries failed syncs for up to 7 days.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.growsurf.com/integrations/aweber.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
