batch_subscribe
Add or update up to 500 members in one request. Use for bulk operations; pending members receive a double opt-in email.
Instructions
Add or update up to 500 members in a single synchronous request.
Use for bulk operations. Choose the right member tool: batch_subscribe for 2-500 members, add_member or update_member for a single member, create_batch for imports larger than 500. Side effect: members with status='pending' each receive a double opt-in confirmation email.
Authenticated via API key. Max 10 concurrent requests. Respects read-only and dry-run modes.
Args: list_id: Audience/list ID (10-char alphanumeric, e.g. 'abc123def4'). Obtain from list_audiences. members_json: JSON array of members (max 500). Each requires email_address and status ('subscribed'/'unsubscribed'/'cleaned'/'pending'). Optional: merge_fields, tags. update_existing: If true (default), existing members are updated. If false, skipped as errors.
Returns: JSON with new_members, updated_members, errors array, total_created, total_updated, error_count.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list_id | Yes | ||
| members_json | Yes | ||
| update_existing | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |