---
canonical_url: "https://docs.composio.dev/toolkits/aweber"
markdown_url: "https://docs.composio.dev/toolkits/aweber.md"
product: "platform"
version: null
last_updated: null
---

# AWeber

Use AWeber's complete stable v1 API to manage accounts, lists, subscribers, custom fields, purchases, broadcasts and schedules, campaigns, integrations, landing pages, web forms, and engagement analytics

- **Category:** marketing automation
- **Auth:** OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 32
- **Triggers:** 0
- **Slug:** `AWEBER`
- **Version:** 00000000_00

## Tools

### Add Subscriber

**Slug:** `AWEBER_ADD_SUBSCRIBER`

Add one consented subscriber to an AWeber list. This is not a bulk-import endpoint; AWeber considers bulk use abuse and directs large imports to its list importer. Adding a subscriber can start autoresponder follow-ups, and supplied tags can trigger Campaign automation. Review list permission and consent before calling. This tool is create-only and does not update an existing subscriber; use an explicit update tool for existing records. HTTP 201 confirms creation, not message delivery.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Subscriber name. |
| `tags` | array | No | Tags to apply. Tags can immediately trigger AWeber Campaign automation and message sequences. |
| `email` | string | Yes | Subscriber email address. Add only a person who consented to receive this list's email. |
| `list_id` | integer | Yes | Numeric list ID to which the subscriber consented to subscribe. |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `ip_address` | string | No | Public IPv4 address observed when the subscriber consented. Supply the real subscriber IP only; do not infer or fabricate it. AWeber accepts it only on initial creation and uses it to derive geographic fields. |
| `misc_notes` | string | No | Customer notes about this subscriber; may contain sensitive personal data. |
| `ad_tracking` | string | No | Customer-defined advertising attribution value. |
| `custom_fields` | object | No | Values for custom fields that already exist on this list. |
| `strict_custom_fields` | boolean | No | When true, match custom-field names case-sensitively and fail if any supplied field is not defined on the list. |
| `last_followup_message_number_sent` | integer | No | Destination follow-up position. Omitted or 0 means the first autoresponder follow-up may be sent; 1001 prevents further follow-up messages. |
| `confirm_consent_and_possible_automation` | boolean | Yes | Must be true to confirm current subscriber consent and acknowledge that adding the subscriber can start autoresponder or tag-triggered email automation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Broadcast Schedule

**Slug:** `AWEBER_CANCEL_BROADCAST_SCHEDULE`

Cancel an AWeber broadcast's existing delivery schedule. This stops the scheduled delivery request and requires explicit confirmation. A 200 response confirms that AWeber accepted the cancellation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric list ID containing the broadcast. |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `broadcast_id` | integer | Yes | Numeric broadcast ID whose existing schedule should be canceled. |
| `confirm_cancel_schedule` | boolean | Yes | Must be true to confirm cancellation of the customer-visible delivery schedule. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Broadcast Draft

**Slug:** `AWEBER_CREATE_BROADCAST_DRAFT`

Create an API-managed AWeber broadcast draft for later review or editing. This action does not schedule or send email. The response describes the saved draft; treat status='draft' and a returned broadcast_id or self_link as creation confirmation, not as delivery confirmation. Only API-created drafts are eligible for the companion update and delete actions, and the form-encoded request must remain within AWeber's 1,000,000-byte limit.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric list ID that owns the draft. |
| `subject` | string | Yes | Broadcast subject line of 1-120 characters; whitespace-only subjects are rejected. |
| `body_amp` | string | No | Optional AMP message body. Use only valid AMP for Email markup. |
| `body_html` | string | No | Optional HTML message body; provide this or body_text. If body_text is omitted, AWeber generates plain text from this HTML. |
| `body_text` | string | No | Optional plain-text message body; provide this or body_html. If body_html is omitted, a future send is text-only. |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `segment_id` | integer | No | Optional numeric segment ID to target. Omit to use AWeber's Active Subscribers segment. This only configures the draft and does not send it. |
| `is_archived` | boolean | No | Whether a future send may be shared through an archive URL. Defaults to false instead of AWeber's true default. |
| `notify_on_send` | boolean | No | Whether AWeber should notify the account after statistics become available for a future send. Defaults to false instead of AWeber's true default. |
| `exclude_list_ids` | array | No | Optional positive numeric list IDs to exclude from delivery. |
| `include_list_ids` | array | No | Optional positive numeric list IDs to include in delivery in addition to the owning list. |
| `click_tracking_enabled` | boolean | No | Whether links in a future send should be tracked. Defaults to false instead of AWeber's true default. |
| `twitter_integration_id` | integer | No | Optional positive numeric AWeber Twitter integration ID; a later send tweets the broadcast subject. This draft action does not send. |
| `facebook_integration_id` | integer | No | Optional positive numeric AWeber Facebook integration ID; a later send posts the broadcast subject to Facebook. This draft action does not send. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Custom Field

**Slug:** `AWEBER_CREATE_CUSTOM_FIELD`

Create a named custom subscriber field on one AWeber mailing list. AWeber returns no JSON body; the response exposes its Location header and parsed field ID when available. Otherwise use AWEBER_LIST_CUSTOM_FIELDS to discover it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Non-empty name for the new custom subscriber field. |
| `list_id` | integer | Yes | Numeric list ID on which to create the custom field. |
| `account_id` | integer | Yes | Numeric AWeber account ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Broadcast Draft

**Slug:** `AWEBER_DELETE_BROADCAST_DRAFT`

Permanently delete one unsent broadcast draft created through the AWeber API. This irreversible operation cannot be undone. It does not send email, and scheduled or sent broadcasts are not eligible for deletion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric mailing list ID that contains the API-created draft. |
| `account_id` | integer | Yes | Numeric AWeber account ID that owns the mailing list. |
| `broadcast_id` | integer | Yes | Numeric ID of the API-created, unsent broadcast draft to permanently delete. Scheduled or sent broadcasts are not eligible. |
| `confirm_permanent_deletion` | boolean | Yes | Must be true to confirm permanent deletion of this unsent API-created draft. This value is not sent to AWeber. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Custom Field

**Slug:** `AWEBER_DELETE_CUSTOM_FIELD`

Permanently delete one custom field definition at the exact AWeber path identified by account_id, list_id, and custom_field_id. This irreversible operation removes the field from the list; do not use it as proof that historical subscriber data was erased. Use only when the field is no longer needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric mailing list ID that contains the custom field. |
| `account_id` | integer | Yes | Numeric AWeber account ID that owns the mailing list. |
| `custom_field_id` | integer | Yes | Numeric ID of the custom field to permanently delete from the specified account and mailing list. |
| `confirm_permanent_deletion` | boolean | Yes | Must be true to confirm permanent deletion of this custom field definition. This value is not sent to AWeber. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Subscriber

**Slug:** `AWEBER_DELETE_SUBSCRIBER`

Permanently delete one AWeber subscriber by current email or numeric ID. Obtain explicit user confirmation before calling and set confirm_permanent_deletion=true. This unsubscribes the person and permanently removes related analytics/activity; click/open references become 'Deleted Subscriber'. For a non-destructive opt-out that retains analytics, use AWEBER_UPDATE_SUBSCRIBER_CONSENT_AND_AUTOMATION with status='unsubscribed' and its required confirmation instead.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric list ID containing the subscriber. |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `subscriber_id` | integer | No | Numeric subscriber ID used to select the subscriber. Provide this or subscriber_email, not both. |
| `subscriber_email` | string | No | Current email used to select the subscriber. Provide this or subscriber_id, not both. |
| `confirm_permanent_deletion` | boolean | Yes | Must be true after explicit user confirmation. Deletion unsubscribes the person, permanently removes related analytics/activity, and changes click/open references to 'Deleted Subscriber'. This value is never sent to AWeber. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Broadcast

**Slug:** `AWEBER_GET_BROADCAST`

Return one specific AWeber broadcast by numeric ID, including its content, lifecycle status, targeting, tracking settings, and schedule or send metadata. Draft lookup is for API-created drafts discoverable through AWeber's API; this read-only action does not schedule or send the broadcast.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric list ID containing the broadcast. |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `broadcast_id` | integer | Yes | Numeric ID of the specific broadcast to retrieve, returned by AWEBER_LIST_BROADCASTS or AWEBER_CREATE_BROADCAST_DRAFT. Draft IDs discoverable through the API refer only to API-created drafts. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subscriber

**Slug:** `AWEBER_GET_SUBSCRIBER`

Return one AWeber subscriber by numeric ID, including personally identifiable information (PII), subscription status, tags, custom fields, lifecycle timestamps, customer notes, IP address, and precise latitude/longitude when available. Use sensitive results only for the requested task; do not log or expose them unnecessarily.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric AWeber list ID containing the subscriber. |
| `account_id` | integer | Yes | Numeric AWeber account ID returned by AWEBER_LIST_ACCOUNTS. |
| `subscriber_id` | integer | Yes | Numeric subscriber ID returned by AWEBER_SEARCH_SUBSCRIBERS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Accounts

**Slug:** `AWEBER_LIST_ACCOUNTS`

List one page of AWeber customer accounts authorized by the connected OAuth account, or retrieve one account by account_id. Results include the numeric account IDs and UUIDs needed by other tools. Use next_cursor to retrieve additional collection pages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum accounts to return in this page (1-100). |
| `account_id` | integer | No | Numeric AWeber account ID to retrieve; omit to list authorized accounts. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Broadcast Engagement

**Slug:** `AWEBER_LIST_BROADCAST_ENGAGEMENT`

Return one page of sensitive subscriber-level opens or clicks for a sent broadcast. Clicks can be aggregated per subscriber or detailed as individual tracked URL events. email.read permits the analytics read; subscriber email addresses appear only when subscriber.read is also granted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric list ID containing the sent broadcast. |
| `detailed` | boolean | No | For clicks only, return each tracked URL click event instead of one aggregate per subscriber. |
| `page_size` | integer | No | Maximum engagement entries in this page (1-100). |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; pass it with the same engagement_type to continue. |
| `broadcast_id` | integer | Yes | Numeric sent-broadcast ID whose engagement events to retrieve. |
| `engagement_type` | string ("opens" | "clicks") | Yes | Select opens or clicks. This chooses the corresponding fixed AWeber route. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Broadcasts

**Slug:** `AWEBER_LIST_BROADCASTS`

List one page of broadcasts for a mailing list by required lifecycle status, or set count_only=true to return only total_size. Draft results and counts include only broadcasts created through the API.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("draft" | "scheduled" | "sent") | Yes | Broadcast lifecycle status to return; draft includes only API-created drafts. |
| `list_id` | integer | Yes | Numeric list ID whose broadcasts to return. |
| `page_size` | integer | No | Maximum broadcasts to return in this page (1-100). |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `count_only` | boolean | No | Set true to return only total_size for the selected status; entries will be empty. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Broadcast Statistics

**Slug:** `AWEBER_LIST_BROADCAST_STATISTICS`

List one page of aggregate, time-series, link-ranked, and subscriber-ranked statistics for a broadcast campaign message, or retrieve one exact statistic. Subscriber-ranked values can contain sensitive engagement or sales data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric list ID containing the broadcast campaign message. |
| `stats_id` | string ("total_clicks" | "unique_clicks" | "total_opens" | "unique_opens" | "total_sales" | "total_sales_dollars" | "total_unsubscribed" | "hourly_opens" | "hourly_clicks" | "hourly_webhits" | "hourly_sales" | "hourly_unsubscribed" | "daily_opens" | "daily_clicks" | "daily_webhits" | "daily_sales" | "daily_unsubscribed" | "clicks_by_link" | "webhits_by_link" | "opens_by_subscriber" | "sales_by_subscriber") | No | Optional exact statistic ID. Omit to list one page of all available statistics. |
| `page_size` | integer | No | Maximum statistics in a collection page (1-100). |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `campaign_id` | integer | Yes | Numeric broadcast campaign-message ID; the route's b prefix is added automatically. |
| `next_cursor` | string | No | Opaque collection cursor from a previous call; valid only when stats_id is omitted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Custom Fields

**Slug:** `AWEBER_LIST_CUSTOM_FIELDS`

List one page of custom subscriber fields defined for an AWeber mailing list, or retrieve one field by custom_field_id. Use next_cursor to retrieve additional collection pages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric list ID whose custom fields to return. |
| `page_size` | integer | No | Maximum custom fields to return in this page (1-100). |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; omit for the first page. |
| `custom_field_id` | integer | No | Numeric custom field ID to retrieve; omit to list custom fields. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Integrations

**Slug:** `AWEBER_LIST_INTEGRATIONS`

List one page of integrations connected to an AWeber account, or retrieve one integration by integration_id. Integration self links can be used by compatible broadcast tools for social cross-posting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum integrations to return in this page (1-100). |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `next_cursor` | string | No | Opaque cursor returned by a previous collection call; omit for the first page. |
| `integration_id` | integer | No | Numeric integration ID to retrieve; omit to list connected integrations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Landing Pages

**Slug:** `AWEBER_LIST_LANDING_PAGES`

List one page of landing-page summaries for an AWeber mailing list, or provide landing_page_id to retrieve one page including its potentially large draft and published HTML.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Positive numeric mailing-list ID whose landing pages to inspect. |
| `page_size` | integer | No | Maximum landing pages to return in this collection page (1-100). |
| `account_id` | integer | Yes | Positive numeric AWeber account ID returned by AWEBER_LIST_ACCOUNTS. |
| `next_cursor` | string | No | Opaque cursor returned by a previous collection call; omit for the first page. Do not use with landing_page_id. |
| `landing_page_id` | string | No | Landing-page UUID returned by this tool. Provide it to retrieve one page with its draft and published HTML; omit it to list landing pages. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Legacy Campaign Messages

**Slug:** `AWEBER_LIST_LEGACY_CAMPAIGN_MESSAGES`

List one page of AWeber's legacy campaign message resources, filter by broadcast/followup type, or retrieve one message by type and ID. In this API, campaign means a sent or followup message resource, not the newer Campaigns automation product.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric list ID whose messages to inspect. |
| `page_size` | integer | No | Maximum campaign messages in a collection page (1-100). |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `campaign_id` | integer | No | Together with campaign_type, selects one message. Omit both to list messages. |
| `next_cursor` | string | No | Opaque collection cursor from a previous call; valid only when campaign_id is omitted. |
| `campaign_type` | string ("b" | "f") | No | Filter collection results to b broadcasts or f followups, or combine with campaign_id to retrieve one message. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Lists

**Slug:** `AWEBER_LIST_LISTS`

List one page of mailing lists for an AWeber account, optionally filtering by list name or unique list ID, or retrieve one mailing list by list_id. Use next_cursor to retrieve additional collection pages, or set show_total_size_only=total_size for a filtered count-only response.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Optional list name or unique list ID to match (1-100 characters). |
| `list_id` | integer | No | Numeric mailing-list ID to retrieve; omit to list or search mailing lists. |
| `page_size` | integer | No | Maximum lists to return in this page (1-100). |
| `account_id` | integer | Yes | Positive numeric AWeber account ID returned by AWEBER_LIST_ACCOUNTS. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; omit for the first page. |
| `show_total_size_only` | string | No | Set to total_size to return only the number of matching lists; omit for paginated list entries. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Segments

**Slug:** `AWEBER_LIST_SEGMENTS`

List audience segments for a mailing list, or retrieve one segment by segment_id, so valid broadcast targeting choices can be inspected. Collection mode returns one page and an opaque continuation cursor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric list ID whose segments to return. |
| `page_size` | integer | No | Maximum segments to return in this page (1-100). |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `segment_id` | integer | No | Numeric segment ID to retrieve; omit to list segments. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Subscriber Activity

**Slug:** `AWEBER_LIST_SUBSCRIBER_ACTIVITY`

Retrieve one page of a subscriber's chronological activity, including subscription, verification, message delivery, open, click, and tracked events. Results can contain sensitive behavioral data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric list ID containing the subscriber. |
| `page_size` | integer | No | Maximum activity events to return (1-100). |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `next_cursor` | string | No | Opaque cursor from a previous activity response; omit for the first page. |
| `subscriber_id` | integer | Yes | Numeric subscriber ID whose chronological activity to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tags

**Slug:** `AWEBER_LIST_TAGS`

Get up to 500 tags used by subscribers on an AWeber mailing list, sorted by descending popularity. This read does not add tags or trigger campaigns.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric mailing-list ID whose tags to return. |
| `account_id` | integer | Yes | Numeric AWeber account ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Web Forms

**Slug:** `AWEBER_LIST_WEB_FORMS`

List one page of web forms across an account or for one mailing list, or retrieve one web form when list_id and webform_id are both provided; webform_id cannot be used without list_id. Collection results include display, submission, and conversion metrics and support continuation with next_cursor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | No | Numeric list ID containing the web forms. Required with webform_id; omit both IDs to list forms across the account. |
| `page_size` | integer | No | Maximum web forms to return in collection mode (1-100). |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `webform_id` | integer | No | Optional numeric web form ID; item mode requires both list_id and webform_id. Omit webform_id to list forms. |
| `next_cursor` | string | No | Opaque cursor from a previous collection response; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Web Form Split Test Components

**Slug:** `AWEBER_LIST_WEB_FORM_SPLIT_TEST_COMPONENTS`

List one page of components in an AWeber web form split test, or retrieve one component when component_id is provided. Use next_cursor to continue a collection listing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric list ID containing the split test. |
| `page_size` | integer | No | Maximum components to return in collection mode (1-100). |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `next_cursor` | string | No | Opaque cursor from a previous collection response; omit for the first page. |
| `component_id` | string | No | Optional split-test component ID. Omit to list one page of components. |
| `split_test_id` | integer | Yes | Numeric web form split-test ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Web Form Split Tests

**Slug:** `AWEBER_LIST_WEB_FORM_SPLIT_TESTS`

List one page of web form split tests across an account or for one mailing list, or retrieve one split test when list_id and split_test_id are both provided; split_test_id cannot be used without list_id. Use next_cursor to continue a collection listing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | No | Numeric list ID containing split tests. Required with split_test_id; omit both IDs for account-wide listing. |
| `page_size` | integer | No | Maximum split tests to return in collection mode (1-100). |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `next_cursor` | string | No | Opaque cursor from a previous collection response; omit for the first page. |
| `split_test_id` | integer | No | Optional numeric split-test ID; item mode requires both list_id and split_test_id. Omit it to list split tests. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Move Subscriber

**Slug:** `AWEBER_MOVE_SUBSCRIBER`

Move a currently subscribed person between two lists owned by the same AWeber account. AWeber unsubscribes the source membership and subscribes the destination membership without sending a verification message. By default the destination starts at the first follow-up, which can cause autoresponder delivery; use 1001 to suppress further follow-ups. Custom-field mappings may differ between lists, and the operation has no documented idempotency guarantee.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `subscriber_id` | integer | Yes | Numeric subscriber ID on the source list. |
| `source_list_id` | integer | Yes | Numeric source list ID. The subscriber must currently have status subscribed on this list. |
| `destination_list_id` | integer | Yes | Numeric destination list ID owned by the same AWeber account as the source list. |
| `enforce_custom_field_mapping` | boolean | No | When true, fail unless source custom fields match destination fields case-insensitively; use this to avoid silently losing mismatched values. |
| `last_followup_message_number_sent` | integer | No | Destination follow-up position. Omitted or 0 starts at the beginning, so the first autoresponder follow-up may be sent; 1001 prevents further follow-up messages. |
| `confirm_membership_move_and_possible_delivery` | boolean | Yes | Must be true to confirm source unsubscribe, destination subscribe, and possible destination follow-up delivery. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Record Subscriber Tracked Event

**Slug:** `AWEBER_RECORD_SUBSCRIBER_TRACKED_EVENT`

Record one AWeber purchase/pageview tracked event and create the consented subscriber if absent or update the subscriber if present. The purchase, subscriber changes, or supplied tags can trigger automation. One call consumes three AWeber API requests toward the 120-per-minute account limit, and no idempotency key is documented, so do not retry blindly. HTTP 202 only means accepted for asynchronous processing; it does not prove completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | HTTP(S) URL for the page or tracked event. |
| `name` | string | No | Optional subscriber name. |
| `tags` | array | No | Optional subscriber tags; tags and the purchase event can trigger AWeber automation. |
| `email` | string | Yes | Subscriber email tied to the purchase; AWeber creates or updates this subscriber. Only create subscription state for a person with valid consent. |
| `value` | number | Yes | Monetary value associated with the tracked event. |
| `vendor` | string | Yes | Sales-tracking vendor or profile name. |
| `list_id` | integer | Yes | Numeric list ID on which to record the purchase and upsert the subscriber. |
| `currency` | string | Yes | Uppercase three-letter ISO 4217 currency code, such as USD. |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `event_note` | string | Yes | Custom note associated with this specific tracked event. |
| `event_time` | string | Yes | Timestamp when the event occurred. AWeber documents values such as 2015-07-31 11:36:34-04:00. |
| `ip_address` | string | Yes | Real public IPv4 address associated with the tracked event; do not infer or fabricate it. |
| `misc_notes` | string | No | Optional subscriber notes; may contain sensitive personal data. |
| `ad_tracking` | string | No | Optional advertising-attribution value for the subscriber. |
| `product_name` | string | Yes | Product or tracked-page description. |
| `custom_fields` | object | No | Optional subscriber custom-field values; fields must already exist on the list. When this updates an existing subscriber, treat the map as a complete replacement and include every current field/value because omitted fields can become null. |
| `confirm_consent_upsert_and_possible_automation` | boolean | Yes | Must be true to confirm valid subscriber consent, subscriber create/update effects, tracked-event recording, and possible automation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Schedule Broadcast

**Slug:** `AWEBER_SCHEDULE_BROADCAST`

Schedule an AWeber broadcast for audience email delivery at a future time. This is consequential and requires explicit confirmation because delivery can begin once the scheduled time arrives. A 200 response confirms acceptance, not eventual delivery.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric list ID containing the broadcast. |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `broadcast_id` | integer | Yes | Numeric draft broadcast ID to schedule. |
| `scheduled_for` | string | Yes | Future ISO-8601 timestamp with timezone when AWeber may begin audience email delivery. |
| `confirm_schedule_can_deliver_email` | boolean | Yes | Must be true to confirm that scheduling can cause email delivery to the broadcast audience. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Subscribers

**Slug:** `AWEBER_SEARCH_SUBSCRIBERS`

Search exact subscriber attributes across an account or within one AWeber mailing list, or return all subscribers in a list when no filters are supplied. Use next_cursor for additional pages, or set show_total_size_only=total_size for a count-only response. Results contain sensitive personal data, including email addresses, names, custom fields, and lifecycle status; use them only for the requested task and do not add them to logs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | No | Optional subscriber city to match by full value, case-sensitively. This is location PII. |
| `name` | string | No | Optional subscriber name of 1-60 characters to match exactly and case-sensitively. This is personal data. |
| `tags` | array | No | Optional full, case-sensitive tag values that must all be present on matching subscribers. |
| `email` | string | No | Optional valid subscriber email address of at most 50 characters to match by full value, case-sensitively. This is personal data. |
| `region` | string | No | Optional subscriber state, province, or region to match by full value, case-sensitively. This is location PII. |
| `status` | string ("subscribed" | "unsubscribed" | "unconfirmed") | No | Optional subscription lifecycle status to match. |
| `country` | string | No | Optional subscriber country to match by full value, case-sensitively. This is location PII. |
| `list_id` | integer | No | Numeric AWeber list ID whose subscribers should be searched. Omit to search across the account. |
| `dma_code` | integer | No | Optional US or Canada designated market area code from 0 through 881. |
| `latitude` | number | No | Optional subscriber latitude to match. This is precise location PII. |
| `sort_key` | string ("subscribed_at" | "unsubscribed_at") | No | Optional date field used to sort results. |
| `area_code` | integer | No | Optional subscriber area code from 0 through 999. |
| `longitude` | number | No | Optional subscriber longitude to match. This is precise location PII. |
| `page_size` | integer | No | Maximum subscribers to return from this AWeber list page (1-100). |
| `account_id` | integer | Yes | Numeric AWeber account ID returned by AWEBER_LIST_ACCOUNTS. |
| `misc_notes` | string | No | Optional customer note to match by full value, case-sensitively. This may contain sensitive personal data. |
| `sort_order` | string ("asc" | "desc") | No | Optional sort direction for sort_key; AWeber defaults to ascending. |
| `ad_tracking` | string | No | Optional customer advertising-attribution value to match by full value, case-sensitively. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; pass it unchanged to continue the same sensitive search and list restriction. |
| `postal_code` | string | No | Optional subscriber postal code to match by full value, case-sensitively. This is location PII. |
| `tags_not_in` | array | No | Optional full, case-sensitive tag values that must all be absent from matching subscribers. |
| `verified_at` | string | No | Optional exact email-verification date in YYYY-MM-DD or MM-DD-YYYY format. |
| `custom_fields` | object | No | Optional custom-field name/value object whose full values must match case-sensitively. |
| `subscribed_at` | string | No | Optional exact subscription date in YYYY-MM-DD or MM-DD-YYYY format. |
| `unsubscribed_at` | string | No | Optional exact unsubscribe date in YYYY-MM-DD or MM-DD-YYYY format. |
| `subscribed_after` | string | No | Optional inclusive lower subscription-date bound in YYYY-MM-DD or MM-DD-YYYY format. |
| `subscribed_before` | string | No | Optional inclusive upper subscription-date bound in YYYY-MM-DD or MM-DD-YYYY format. |
| `unsubscribe_method` | string ("unsubscribe link" | "customer cp" | "undeliverable" | "api: unsubscribe" | "api: move") | No | Optional method by which the subscriber unsubscribed. |
| `unsubscribed_after` | string | No | Optional inclusive lower unsubscribe-date bound in YYYY-MM-DD or MM-DD-YYYY format. |
| `subscription_method` | string ("api" | "email" | "import" | "webform") | No | Optional method by which the subscriber joined. |
| `unsubscribed_before` | string | No | Optional inclusive upper unsubscribe-date bound in YYYY-MM-DD or MM-DD-YYYY format. |
| `show_total_size_only` | string | No | Set to total_size to return only the number of matching subscribers; omit for paginated entries. |
| `last_followup_message_sent_at` | string | No | Optional exact last-follow-up date in YYYY-MM-DD or MM-DD-YYYY format. |
| `last_followup_message_number_sent` | integer | No | Optional last follow-up sequence number; 1001 means no further follow-ups. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Broadcast Draft

**Slug:** `AWEBER_UPDATE_BROADCAST_DRAFT`

Safely update one or more fields on an API-created AWeber broadcast draft. The tool first reads the draft and preserves omitted targeting, integration, list, content, tracking, archive, and notification settings before replacing its details. It can replace list, segment, social integration, and AMP settings; empty include/exclude list arrays clear those list settings. Supplying HTML without text asks AWeber to generate text; supplying text without HTML makes the message text-only. This tool cannot update scheduled, sending, or sent broadcasts and does not schedule or send email.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | integer | Yes | Numeric list ID containing the API-created draft. |
| `subject` | string | No | Replacement subject line of 1-120 characters; it must contain a non-whitespace character. |
| `body_amp` | string | No | Replacement AMP body. Pass an empty string to clear existing AMP content. |
| `body_html` | string | No | Replacement HTML body. Supply body_text with it to prevent AWeber from auto-generating and overwriting the plain-text body. |
| `body_text` | string | No | Replacement plain-text body. Supply body_html with it so both message representations are replaced explicitly. |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `segment_id` | integer | No | Replacement numeric segment ID. To restore Active Subscribers targeting, pass that segment's ID from AWEBER_LIST_SEGMENTS. This does not send email. |
| `is_archived` | boolean | No | Replacement setting for sharing a future sent broadcast through an archive URL. |
| `broadcast_id` | integer | Yes | Numeric ID of an API-created draft; scheduled, sending, or sent broadcasts cannot be updated with this tool. |
| `notify_on_send` | boolean | No | Replacement setting for notifying the account when statistics become available after a future send. |
| `exclude_list_ids` | array | No | Replacement positive numeric list IDs to exclude; pass an empty list to clear exclusions. |
| `include_list_ids` | array | No | Replacement positive numeric list IDs to include; pass an empty list to clear additional included lists. |
| `click_tracking_enabled` | boolean | No | Replacement setting for tracking links in a future send. |
| `twitter_integration_id` | integer | No | Replacement Twitter integration ID; a later send tweets the subject. This draft action does not send. |
| `facebook_integration_id` | integer | No | Replacement Facebook integration ID; a later send posts the subject to Facebook. This draft action does not send. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Custom Field

**Slug:** `AWEBER_UPDATE_CUSTOM_FIELD`

Rename an AWeber custom subscriber field or change whether subscribers may update it. Renaming a populated field can make existing values semantically incorrect and break personalization or segments because AWeber stores values by field number. At least one mutable setting must be provided.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Optional new non-empty name for the custom field. |
| `list_id` | integer | Yes | Numeric AWeber list ID containing the custom field. |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `custom_field_id` | integer | Yes | Numeric custom field ID returned by AWEBER_LIST_CUSTOM_FIELDS. |
| `is_subscriber_updateable` | boolean | No | Optional setting controlling whether subscribers may update this field. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Subscriber

**Slug:** `AWEBER_UPDATE_SUBSCRIBER`

Update reversible profile fields for one AWeber subscriber selected by current email or numeric ID. This tool cannot change consent status, autoresponder position, or tags; use UPDATE_SUBSCRIBER_CONSENT_AND_AUTOMATION for those consequential changes. For custom_fields, the tool reads and merges current values before sending AWeber's complete replacement map, preserving omitted fields. AWeber's documented success status is HTTP 209.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Replacement subscriber name. |
| `list_id` | integer | Yes | Numeric list ID containing the subscriber. |
| `new_email` | string | No | Replacement subscriber email. This changes the address; subscriber_email only selects the record. |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `misc_notes` | string | No | Replacement customer notes; may contain sensitive personal data. |
| `ad_tracking` | string | No | Replacement advertising-attribution value. |
| `custom_fields` | object | No | Custom-field values to change. The tool reads the current subscriber and merges these values before sending AWeber's required complete replacement map, preserving other existing fields. Only values, not field definitions, can be changed. |
| `subscriber_id` | integer | No | Numeric subscriber ID used to select the subscriber. Provide this or subscriber_email, not both. |
| `subscriber_email` | string | No | Current email used to select the subscriber. Provide this or subscriber_id, not both. |
| `strict_custom_fields` | boolean | No | When true, match custom-field names case-sensitively and fail on fields not defined for the list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Subscriber Consent and Automation

**Slug:** `AWEBER_UPDATE_SUBSCRIBER_CONSENT_AND_AUTOMATION`

Change one AWeber subscriber's consent status, autoresponder position, or Campaign tags. These changes can resubscribe a person or cause automated email delivery, so explicit confirmation is required. Use UPDATE_SUBSCRIBER for profile-only edits. AWeber's documented success status is HTTP 209.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | object | No | Tag additions/removals that can start, stop, or redirect Campaign automation. |
| `status` | string ("subscribed" | "unsubscribed") | No | Set consent state. Resubscribe only with current valid consent; use unsubscribed instead of deletion when historical analytics should remain. |
| `list_id` | integer | Yes | Numeric list ID containing the subscriber. |
| `account_id` | integer | Yes | Numeric AWeber account ID. |
| `subscriber_id` | integer | No | Numeric subscriber ID used to select the subscriber. Provide this or subscriber_email, not both. |
| `subscriber_email` | string | No | Current email used to select the subscriber. Provide this or subscriber_id, not both. |
| `last_followup_message_number_sent` | integer | No | Autoresponder position: 0 permits the first follow-up and can cause delivery; 1001 prevents further follow-ups. |
| `confirm_consent_or_automation_change` | boolean | Yes | Must be true to confirm that the requested consent, follow-up, or tag change can alter subscription state or cause automated email delivery. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |