Table of Contents
- AWeber Integration
- Requirements
- How AWeber Authentication Works
- Generate an Authorization Code
- Connect AWeber in Contactum
- Automatic Token Refresh
- Enable AWeber on a Form
- Configure Field Mapping
- Finding Your List ID
- Using Smart Tags
- Name Handling
- How Subscriptions Work
- Example Subscription Request
- Double Opt-In
- Subscriber Behaviour
- Troubleshooting
- Important Notes
AWeber Integration #
Automatically add form submitters as subscribers to an AWeber list when they submit a Contactum form.
Requirements #
- Contactum Pro
- An active AWeber account
- An AWeber authorization code
How AWeber Authentication Works #
AWeber uses OAuth 2.0 authentication instead of static API keys.
- Grant Contactum access inside AWeber
- Copy the one-time authorization code
- Paste the code into Contactum
- Contactum exchanges the code for access and refresh tokens
Generate an Authorization Code #
- Log in to AWeber
- Go to Account Settings → Integrations
- Grant Contactum access permissions
- Copy the authorization code immediately
Authorization codes expire quickly and can only be used once.
Connect AWeber in Contactum #
- Go to Contactum → Settings → Integrations → AWeber
- Paste the authorization code
- Click Save Settings
Contactum automatically exchanges the authorization code for OAuth tokens.
Automatic Token Refresh #
When the access token expires, Contactum automatically refreshes it using the refresh token.
- No manual reconnection required
- Subscriptions continue automatically
Enable AWeber on a Form #
- Open the Contactum form builder
- Go to Form Settings → Integrations
- Enable AWeber
- Click Configure
Configure Field Mapping #
| Field | Required | Description |
|---|---|---|
| List ID | Yes | AWeber subscriber list ID |
| Yes | Map subscriber email field | |
| First Name | No | Subscriber first name |
| Last Name | No | Subscriber last name |
| Double Opt-In | No | Require email confirmation before activation |
Finding Your List ID #
The List ID is the numeric value inside the AWeber list URL.
https://app.aweber.com/lists/1234567/overview
In this example:
1234567
is the List ID.
Using Smart Tags #
Email → {email}
First Name → {first_name}
Last Name → {last_name}
Name Handling #
Contactum automatically combines first and last names:
Jane + Doe → Jane Doe
If no name is provided, the email address is used instead.
How Subscriptions Work #
- The visitor submits the form
- Contactum validates the integration
- The email address is verified
- The subscriber is sent to AWeber
Example Subscription Request #
POST https://api.aweber.com/1.0/accounts/{account_id}/lists/{list_id}/subscribers
Authorization: Bearer {access_token}
ws.op = create
email = subscriber@example.com
name = Jane Doe
Double Opt-In #
| Mode | Behaviour |
|---|---|
| Disabled | Subscriber added immediately |
| Enabled | Subscriber must confirm by email |
Subscriber Behaviour #
| Scenario | Result |
|---|---|
| New email | Subscriber created |
| Existing subscriber | Subscriber updated |
| Invalid email | Subscription skipped |
| Expired token | Automatically refreshed |
Troubleshooting #
Invalid Credentials #
- Authorization codes expire quickly
- Authorization codes are single-use only
- Generate a fresh code if needed
Subscribers Not Appearing #
- Enable AWeber on the form
- Verify the List ID
- Check email field mapping
- Review Contactum entries
Connection Drops #
- The refresh token may be revoked
- Reconnect the integration if needed
Important Notes #
- AWeber uses OAuth 2.0 only
- Authorization codes are temporary
- Tokens are securely stored in WordPress
- Contactum uses the AWeber REST API v1.0