[kavanpancholi]

Why?

The Python SDK was behind the public API. It could read automations but not build, change or control them. It also had the known bugs from ENGL-663: subscribers.update called the upsert route, group import called an internal route, segment subscribers sent after instead of cursor, and two README examples passed page= to methods that did not accept it. This catches it up with every subscribers, groups, segments, fields and automations endpoint on the card.

Changes

1. Known bugs fixed:
   • subscribers.update sends PUT /subscribers/{subscriber}. It used to send POST /subscribers, the upsert. The email or id is URL-quoted in the path. A new new_email kwarg changes the address.
   • groups.import_subscribers_to_group calls the documented POST /groups/{group}/import-subscribers, with resubscribe and trigger_automations.
   • segments.get_subscribers sends cursor, limit and filter[status]. The old after is still sent unchanged.
   • The README examples are fixed. subscribers.list now accepts page, and the group and segment examples page with cursor.
2. New documented params on existing methods: subscriber list (page, sort, include, dates, with_fields, with_groups), subscriber create (resubscribe, double_optin, notes), group subscribers (include), segment list (sort), segment update (filter), automation list (sort, with_steps), automation activity (sort, with_subscribers).
3. New methods: subscribers.activity_log, and automation create, update, delete, copy, enable, disable, test, add_subscribers, readd, the three activity actions, triggers, steps, email content and stats, templates, and the run count, A/B and subscriber reports.
4. mailerlite/sdk/_request_params.py holds the query and body building that the new and changed methods share. Query booleans go out as 1/0, list filter values are comma-joined, None is dropped, and unknown kwargs raise TypeError. with_subscribers is sent only when true, because the API turns it on for any value.
5. Tests: a sent_request fixture patches requests.request, so the new request tests make no network calls. Each new or changed method has a test asserting the HTTP method, path, query and body against the OpenAPI document.

No existing method signature changed and nothing was removed. mailerlite/__init__.py and the client are untouched.

The e-commerce automation reports (monthly-totals/ecommerce, order-activity, ecommerce-overview-stats) are not in this PR, because the open e-commerce PR #106 adds them.

Endpoint checklist

"Live call" means the method was called once against a local API on a test account, and the effect was read back with a separate request.

Subscribers

Endpoint	SDK method	How checked
POST /subscribers	subscribers.create	test + live call
GET /subscribers/{subscriber}	subscribers.get	test + live call
PUT /subscribers/{subscriber}	subscribers.update	test + live call
GET /subscribers/{subscriber}/activity-log	subscribers.activity_log	test + live call
GET /subscribers/import/{import}	subscribers.get_import	test + live call
GET /subscribers	subscribers.list	test + live call
POST /subscribers/{subscriber}/forget	subscribers.forget	test + live call
DELETE /subscribers/{subscriber}	subscribers.delete	test + live call

Groups

Endpoint	SDK method	How checked
POST /groups	groups.create	test + live call
GET /groups	groups.list	test + live call
PUT /groups/{group}	groups.update	test + live call
POST /subscribers/{subscriber}/groups/{group}	subscribers.assign_subscriber_to_group	test + live call
DELETE /subscribers/{subscriber}/groups/{group}	subscribers.unassign_subscriber_from_group	test + live call
GET /groups/{group}/subscribers	groups.get_group_subscribers	test + live call
POST /groups/{group}/import-subscribers	groups.import_subscribers_to_group	test + live call
DELETE /groups/{group}	groups.delete	test + live call

Segments

Endpoint	SDK method	How checked
GET /segments	segments.list	test + live call
PUT /segments/{segment}	segments.update	test + live call
GET /segments/{segment}/subscribers	segments.get_subscribers	test + live call
DELETE /segments/{segment}	segments.delete	test + live call

Fields

Endpoint	SDK method	How checked
POST /fields	fields.create	test + live call
GET /fields	fields.list	test + live call
PUT /fields/{field}	fields.update	test + live call
DELETE /fields/{field}	fields.delete	test + live call

Automations

Endpoint	SDK method	How checked
POST /automations	automations.create	test + live call
PUT /automations/{automation}	automations.update	test + live call
POST /automations/{automation}/test	automations.test	test + live call
POST /automations/{automation}/enable	automations.enable	test + live call
POST /automations/{automation}/add-subscribers	automations.add_subscribers	test + live call
GET /automations/{automation}/activity	automations.activity	test + live call
GET /automations	automations.list	test + live call
POST /automations/{automation}/activity/add-to-group	automations.activity_add_to_group	test + live call
POST /automations/{automation}/activity/skip-delay	automations.activity_skip_delay	test + live call
POST /automations/{automation}/activity/cancel-automation	automations.activity_cancel_automation	test + live call
POST /automations/{automation}/readd	automations.readd	test + live call
POST /automations/{automation}/copy	automations.copy	test + live call
POST /automations/{automation}/disable	automations.disable	test + live call
DELETE /automations/{automation}	automations.delete	test + live call

Automation triggers

Endpoint	SDK method	How checked
POST /automations/{automation}/triggers	automations.create_trigger	test + live call
GET /automations/{automation}/triggers	automations.list_triggers	test + live call
GET /automations/{automation}/triggers/{trigger}	automations.get_trigger	test + live call
PUT /automations/{automation}/triggers/{trigger}	automations.update_trigger	test + live call
DELETE /automations/{automation}/triggers/{trigger}	automations.delete_trigger	test + live call

Automation steps

Endpoint	SDK method	How checked
POST /automations/{automation}/steps	automations.create_step	test + live call
GET /automations/{automation}/steps/index	automations.list_steps	test + live call
GET /automations/{automation}/steps/{step}	automations.get_step	test + live call
PUT /automations/{automation}/steps/{step}	automations.update_step	test + live call
POST /automations/{automation}/steps/{step}/copy	automations.copy_step	test + live call
POST /automations/{automation}/steps/reorder	automations.reorder_steps	test + live call
DELETE /automations/{automation}/steps/{step}	automations.delete_step	test + live call
PUT /automations/{automation}/steps/{step}/select-ab-test-winner	automations.select_ab_test_winner	test + live call

Automation emails

Endpoint	SDK method	How checked
PUT /automations/{automation}/emails/{email}/content	automations.update_email_content	test + live call
GET /automations/{automation}/emails/{email}/content	automations.get_email_content	test + live call
GET /automations/{automation}/emails/{email}/report-stats	automations.email_report_stats	test + live call
GET /automations/{automation}/emails/{email}/unsubscribe-reasons	automations.email_unsubscribe_reasons	test + live call

Automation templates

Endpoint	SDK method	How checked
GET /automation-templates	automations.list_templates	test + live call
POST /automations/select-template/{automationTemplate}	automations.select_template	test + live call

Automation reports

Endpoint	SDK method	How checked
GET /automations/{automation}/steps/run-counts	automations.steps_run_counts	test + live call
GET /automations/{automation}/steps/run-counts/{step}	automations.step_run_counts	test + live call
GET /automations/{automation}/triggers/run-counts	automations.triggers_run_counts	test + live call
GET /automations/{automation}/triggers/run-counts/{trigger}	automations.trigger_run_counts	test + live call
GET /automations/{automation}/activity/steps/{step}/subscribers	automations.step_subscribers	test + live call
GET /automations/{automation}/activity/triggers/{trigger}/subscribers	automations.trigger_subscribers	test + live call
GET /automations/{automation}/monthly-totals/email	automations.email_monthly_totals	test + live call
GET /automations/{automation}/monthly-totals/ecommerce	(none)	not on this branch: added by the open e-commerce PR #106
GET /automations/{automation}/order-activity	(none)	not on this branch: added by the open e-commerce PR #106
GET /automations/{automation}/emails/{email}/ecommerce-overview-stats	(none)	not on this branch: added by the open e-commerce PR #106
GET /automations/{automation}/ab-steps-stats	automations.ab_steps_stats	test + live call
GET /automations/{automation}/ab-steps-stats/{step}	automations.ab_step_stats	test + live call

Risks

Medium. Two fixes from the card change what existing calls do:

• subscribers.update now uses PUT. A subscriber that does not exist now gets a 404 instead of being created. When groups is passed, it replaces the subscriber's group list: groups not listed are removed. Before, the upsert only added groups. subscribers.create still does the additive upsert. The docstring and README say so.
• groups.import_subscribers_to_group now uses the documented route. It returns {"import_progress_url": ...} straight away, not the finished import data the internal route waited for. Poll subscribers.get_import for progress.

These need a minor version bump and a release note.

The open simple-editor PR #107 adds its own mailerlite/sdk/_params.py, with a filter helper that overlaps _request_params.py. The files differ, so there is no conflict, but the two helpers could be merged after both land.

Performance impact

None. Each method makes one request.

Security impact

No security impact. The subscriber path is now URL-quoted, so an email with # or ? can no longer reach the wrong path.

How to QA

No QA needed on the app. This is a library change, and nothing in the MailerLite app changes. Reviewers can run pytest tests/.

Verified before review: 81 of 81 live calls passed, plus 3 skipped (the e-commerce reports that PR #106 adds). The subscribers-update cassette was edited to the new PUT path. The live PUT returned 200 with every key the cassette has. What a local run cannot show: run counts and report stats stay 0, because they read analytics data the local stack does not produce.

pytest tests/ -q: 173 passed, 1 skipped. ruff format --check .: 29 files already formatted.

How to release

Minor release (see Risks). Versioning is handled by semantic-release, so there is no hand-written CHANGELOG.

Rollback strategy

Primary rollback method: revert

Code changes

• Safe to revert. SDK code only.

Database migrations

• None.

Data modifications

• None.

External dependencies

• None.

Configuration changes:

• None.

Screenshots, recordings

N/A, library change.

I used AI to generate parts of this PR

Yes

Docs

The PR adheres to Pull Request guidelines.

See mandatory MailerLite PR rules and flow for more information.

[mailerlite-kritika]

Confidence Score: 4/5

[Medium risk] No finding was reported, but segments.get drops after from its accepted kwargs, so existing callers now get a TypeError, and the description's "nothing was removed" and risk sections do not mention it; the account calls this only a stale doc line. The risk rests on the PUT semantics change of subscribers.update (group replacement, 404 on missing subscribers) and the group import route change, which the description does disclose and the cassette and tests cover; the removeprefix in …

Summary

Catches the Python SDK up with the public subscribers, groups, segments and automations API

The change fixes subscribers.update (now PUT /subscribers/{subscriber}), groups.import_subscribers_to_group (now /import-subscribers) and the segment cursor param. It adds the automation management, report and activity methods. Since the last review, the shared helpers moved into _params.py. excel is rejected on the report methods, after on segment subscribers is now sent as cursor with a DeprecationWarning, and bool subscriber IDs are rejected. Merging changes what existing calls do: subscribers.update no longer creates missing subscribers and replaces groups, and group import returns import_progress_url instead of the finished import. The PR description still says after is "sent unchanged" and that nothing was removed. The code now maps after to cursor, and segments.get no longer accepts after, so those two lines are stale.

What's good

• Each new or changed method has a test asserting HTTP verb, path, query and body through a patched requests.request, with no network calls.
• Subscriber emails are URL-quoted in the path, with tests for # and +.
• Unknown kwargs raise TypeError consistently, and the helpers are merged into the existing _params.py instead of a second module.

Review context · 0/5 commands

• Commands run: none

_{Reviews (3) · Last reviewed commit: "docs: Readme update" · claude-sonnet-5-5}