Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
d500b2f
feat(emails): schedule, move, cancel and list emails
Silthus Nov 12, 2026
067e51d
refactor(emails): check scheduled_at strings with the status timestam…
Silthus Nov 12, 2026
8a365d2
fix(emails): name a too-late 409 as the shared SDK spec does
Silthus Nov 12, 2026
ef74081
fix(emails): match posthog-node on old servers, paging and too-late c…
Silthus Nov 12, 2026
5239890
test(emails): a supported scheduled send carries no scheduling_unsupp…
Silthus Nov 12, 2026
f01179a
Merge main into feat/email-scheduled-send
Silthus Nov 12, 2026
7d225c3
test(emails): one async test per scheduled-send behavior
Silthus Nov 12, 2026
baf3bf0
Merge main into feat/email-scheduled-send
Silthus Nov 12, 2026
afa81b7
test(emails): a list row missing any one field raises
Silthus Nov 12, 2026
9b8d122
test(emails): an update reply missing any one field raises
Silthus Nov 13, 2026
042f4ab
test(emails): a cancel reply without an ID and a list reply without r…
Silthus Nov 13, 2026
36eeabc
Merge main into feat/email-scheduled-send
Silthus Nov 13, 2026
001e1b1
fix(emails): refuse a move after one that got no answer
Silthus Nov 13, 2026
9de6d1e
Merge remote-tracking branch 'origin/main' into feat/email-scheduled-…
Silthus Nov 13, 2026
86075ee
fix(emails): count a 5xx move as unconfirmed and compare moves by ins…
Silthus Nov 13, 2026
6b38780
fix(emails): forget an email's unconfirmed move once a cancel is conf…
Silthus Nov 13, 2026
354b048
Merge remote-tracking branch 'origin/main' into feat/email-scheduled-…
Silthus Nov 13, 2026
3d5caea
fix(emails): keep a cancel's cleanup when a move of that email ends a…
Silthus Nov 13, 2026
cf2899e
fix(emails): read list rows without a recipient, as D5 now answers
Silthus Nov 13, 2026
e8939d2
fix(emails): moves out or queued at a confirmed cancel record nothing
Silthus Nov 13, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 23 additions & 4 deletions .github/scripts/check_strict_types.sh
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,9 @@ import atexit

import posthog
from posthog import FeatureFlagEvaluations, FlagValue, Posthog
from posthog.emails import AsyncEmails, Emails, SendEmailResult
from datetime import datetime, timezone

from posthog.emails import AsyncEmails, CancelEmailResult, EmailList, Emails, SendEmailResult, UpdateEmailResult
from posthog.ai.evaluations import (
AsyncOfflineEvaluations,
BooleanScorerConfig,
Expand Down Expand Up @@ -46,16 +48,28 @@ _ = (flag_value, all_flags, enabled, payload, evaluations, active)
emails = Emails("phs_example")
template_send: SendEmailResult = emails.send(to="user@example.com", template_id="0190f6d2-7c1e-7b3a-9f5e-1c2d3e4f5a6b", template_data={"name": "Ada"})
rendered_send: SendEmailResult = emails.send(to="user@example.com", template_key="password-reset", subject="Reset", html="<p>Reset</p>", from_="Acme <security@example.com>", reply_to=["help@example.com"], capture_engagement=False, max_retries=0)
scheduled_send: SendEmailResult = emails.send(to="user@example.com", template_id="0190f6d2-7c1e-7b3a-9f5e-1c2d3e4f5a6b", scheduled_at=datetime(2026, 12, 1, tzinfo=timezone.utc))
scheduled_status: str = scheduled_send.status
scheduled_time: datetime | None = scheduled_send.scheduled_at
moved: UpdateEmailResult = emails.update(scheduled_send.id, scheduled_at="2026-12-02T09:00:00+02:00")
canceled: CancelEmailResult = emails.cancel(scheduled_send.id)
page: EmailList = emails.list(cursor=None, limit=50)
next_page: EmailList | None = emails.list(cursor=page.next) if page.next else None
first_time: datetime = page.results[0].scheduled_at
invite_send: SendEmailResult = emails.send(to="user@example.com", template_key="invite", subject="Invite", html="<p>Invite</p>", cc="team@example.com", bcc=["audit@example.com"], attachments=[{"filename": "invite.ics", "content": b"BEGIN:VCALENDAR", "content_type": "text/calendar"}, {"filename": "logo.png", "content": "iVBORw0KGgo=", "content_id": "logo"}])
tracked_send: SendEmailResult = emails.send(to="user@example.com", template_key="welcome", subject="Welcome", html="<p>Hi</p>", tracking={"clicks": True, "engagement": False})
untracked_send: SendEmailResult = emails.send(to="user@example.com", template_key="welcome", subject="Welcome", html="<p>Hi</p>", tracking=False)
not_sensitive_send: SendEmailResult = emails.send(to="user@example.com", template_key="newsletter", subject="News", html="<p>News</p>", sensitive=False)
_ = (template_send, rendered_send, invite_send, tracked_send, untracked_send, not_sensitive_send)
_ = (template_send, rendered_send, invite_send, tracked_send, untracked_send, not_sensitive_send, scheduled_status, scheduled_time, moved, canceled, next_page, first_time)


async def async_email_types() -> None:
sent: SendEmailResult = await AsyncEmails("phs_example").send(to="user@example.com", template_key="welcome", subject="Hi", html="<p>Hi</p>")
_ = sent
async_emails = AsyncEmails("phs_example")
sent: SendEmailResult = await async_emails.send(to="user@example.com", template_key="welcome", subject="Hi", html="<p>Hi</p>", scheduled_at="2026-12-01T09:00:00Z")
moved: UpdateEmailResult = await async_emails.update(sent.id, scheduled_at=datetime(2026, 12, 2, tzinfo=timezone.utc))
canceled: CancelEmailResult = await async_emails.cancel(sent.id)
page: EmailList = await async_emails.list()
_ = (sent, moved, canceled, page)


async def offline_evaluation_types(
Expand Down Expand Up @@ -114,6 +128,11 @@ Emails("phs_example").send(to="user@example.com", template_id="0190f6d2-7c1e-7b3
Emails("phs_example").send(to="user@example.com", template_id="0190f6d2-7c1e-7b3a-9f5e-1c2d3e4f5a6b", sensitive=False) # expected-type-error
Emails("phs_example").send(to="user@example.com", template_key="welcome", subject="Hi", html="<p>Hi</p>", tracking={"open": False}) # expected-type-error
Emails("phs_example").send(to="user@example.com", template_key="welcome", subject="Hi", html="<p>Hi</p>", template_data={"name": "Ada"}) # expected-type-error
Emails("phs_example").send(to="user@example.com", template_key="welcome", subject="Hi", html="<p>Hi</p>", scheduled_at=1796115600) # expected-type-error
Emails("phs_example").update("0190f6d2-7c1e-7b3a-9f5e-1c2d3e4f5a6b") # expected-type-error
Emails("phs_example").update("0190f6d2-7c1e-7b3a-9f5e-1c2d3e4f5a6b", "2026-12-01T09:00:00Z") # expected-type-error
Emails("phs_example").list("scheduled") # expected-type-error
Emails("phs_example").list(status="sent") # expected-type-error
Emails("phs_example").send(to="user@example.com", template_key="welcome", subject="Hi", html="<p>Hi</p>", attachments=[{"filename": "a.txt", "content": [104, 105]}]) # expected-type-error
Emails("phs_example").send(to="user@example.com", template_key="welcome", subject="Hi", html="<p>Hi</p>", attachments=[{"filename": "a.txt", "content": b"hi", "path": "/tmp/a.txt"}]) # expected-type-error
Emails("phs_example").send(to="user@example.com", template_id="0190f6d2-7c1e-7b3a-9f5e-1c2d3e4f5a6b", attachments=[{"filename": "a.txt", "content": b"hi"}]) # expected-type-error
Expand Down
5 changes: 5 additions & 0 deletions .sampo/changesets/scheduled-email-sends.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
pypi/posthog: minor
---

Schedule a transactional email with `scheduled_at` on `emails.send()`, up to 30 days ahead, and move, cancel or list scheduled emails with `emails.update()`, `emails.cancel()` and `emails.list()`. A naive `datetime` raises `ValueError` before any request. After a move that got no answer or a server error, the client refuses to move that email to another time, with `move_unconfirmed`, since PostHog may still apply the late move. Send results now carry `status` and `scheduled_at`.
Loading
Loading