unitpost 0.2.1__tar.gz → 0.4.0__tar.gz

{unitpost-0.2.1 → unitpost-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: unitpost
-Version: 0.2.1
+Version: 0.4.0
 Summary: Official Unitpost SDK for Python — send email and manage contacts, segments, campaigns, templates, brand kits, domains, suppressions, webhooks, and usage.
 Project-URL: Homepage, https://www.unitpost.com
 Project-URL: Documentation, https://www.unitpost.com/docs
@@ -66,15 +66,16 @@ Pass the key to `Unitpost(...)`, or set `UNITPOST_API_KEY`. Create a key at
 
 | Accessor | Covers |
 | --- | --- |
-| `emails` | Send, batch, list, get, update, stats, inbound (`received_*`) |
+| `email` | Send, batch, list, get, update, stats, inbound (`received_*`) |
+| `email.topics` | Topics + contact topic prefs |
+| `email.campaigns` | Draft, schedule, send, pause/resume |
+| `email.templates` | Template CRUD |
+| `email.domains` | Domains + verify |
+| `sms` | Send, get, list, `brands()`, `numbers()`, contact SMS consent. Available on paid plans: on the free plan `send` returns a `403` with code `limit_reached`, while the reads keep working. |
 | `contacts` | CRUD, import jobs |
 | `contact_fields` | Custom field definitions |
 | `segments` | Segments + membership |
-| `topics` | Topics + contact topic prefs |
-| `campaigns` | Draft, schedule, send, pause/resume |
-| `templates` | Template CRUD |
 | `brand_kits` | Brand kit |
-| `domains` | Domains + verify |
 | `webhooks` | Endpoints + `verify()` |
 | `api_keys` | API key management |
 | `suppressions` | Suppression list |
@@ -98,7 +99,7 @@ complaints are added automatically; you can also add your own:
 unitpost.suppressions.create({"email": "bounced@example.com", "reason": "manual"})
 unitpost.suppressions.create({"emails": ["a@example.com", "b@example.com"]})
 
-# Look one up by id or email; list (optionally filter scope); un-suppress.
+# Look one up by id or email; list your own; un-suppress.
 unitpost.suppressions.get("bounced@example.com")
 for s in unitpost.suppressions.list_all():
     print(s["email"], s["reason"])
@@ -127,9 +128,45 @@ Or from the client (Resend-style alias):
 event = client.webhooks.verify(payload=raw_body, secret=secret, headers=request.headers)
 ```
 
+## Receive a text and answer it
+
+US toll-free, 10DLC and Canadian numbers take replies (`two_way: True` on
+`sms.numbers()`). Subscribe a webhook to `sms.received`, skip STOP and texts
+Unitpost already answered, read the conversation with `participant`, and answer
+without `from` so the reply leaves from the number they texted.
+
+```python
+import os
+from unitpost import Unitpost, verify_webhook
+
+unitpost = Unitpost()  # reads UNITPOST_API_KEY
+
+# Your webhook endpoint, subscribed to sms.received. Pass the RAW body.
+def on_webhook(raw_body: bytes, headers: dict) -> None:
+    event = verify_webhook(
+        payload=raw_body,
+        secret=os.environ["UNITPOST_WEBHOOK_SECRET"],  # whsec_…
+        headers=headers,
+    )
+    if event["type"] != "sms.received":
+        return
+    reply = event["data"]
+    if reply["keyword"] == "OPT_OUT" or reply["auto_replied"]:
+        return  # STOP, or already answered
+
+    # The whole conversation with this person, both directions, newest first.
+    # Other filters: direction, status, from_ (sent as `from`), to, contact_id,
+    # campaign_id, created_after, created_before.
+    history = unitpost.sms.list(participant=reply["from"], limit=20)
+    answer = your_agent(history.data["data"], reply["body"] or "")
+
+    # No "from": the answer goes out from the number they texted.
+    unitpost.sms.send({"to": reply["from"], "body": answer})
+```
+
 ## Idempotency
 
-`emails.send` and `emails.batch` are safe to retry by default — if you don't pass
+`email.send` and `email.batch` are safe to retry by default — if you don't pass
 `idempotency_key`, the SDK generates one so an automatic retry can't double-send.
 Pass your own to dedupe across separate calls:
 
@@ -149,7 +186,7 @@ Transient failures are retried automatically: `429`, `5xx`, and transport errors
 `Retry-After` is honored; otherwise exponential backoff with full jitter is used.
 Client errors (`401`/`403`/`404`/`409`/`422`) are never retried. Only requests
 safe to replay are retried: `GET`s and writes carrying an idempotency key (which
-`emails.send` and `emails.batch` always do); any other keyless write is never
+`email.send` and `email.batch` always do); any other keyless write is never
 auto-retried.
 
 ```python
@@ -162,7 +199,8 @@ unitpost = Unitpost(max_retries=2, retry_base_delay=0.5, max_retry_delay=20.0)
 | | |
 | --- | --- |
 | Docs + API reference | https://www.unitpost.com/docs |
-| Product / SMTP / MCP guides | https://www.unitpost.com/guides |
+| Product guides | https://www.unitpost.com/guides |
+| SMTP | https://www.unitpost.com/docs/smtp |
 | OpenAPI JSON | https://www.unitpost.com/api/v1/openapi.json |
 | LLM index | https://www.unitpost.com/llms.txt |
 | Dashboard / API keys | https://www.unitpost.com |
@@ -170,7 +208,7 @@ unitpost = Unitpost(max_retries=2, retry_base_delay=0.5, max_retry_delay=20.0)
 | Template gallery | https://www.unitpost.com/templates/gallery |
 | Playground | https://www.unitpost.com/playground |
 | Migration Assistant | https://www.unitpost.com/migration |
-| MCP + Agent Skills | https://www.unitpost.com/guides#ai-mcp · https://www.unitpost.com/guides#ai-skills |
+| MCP + Agent Skills | https://www.unitpost.com/docs/ai/mcp · https://www.unitpost.com/docs/ai/skills |
 | Support | support@unitpost.com |
 
 ## License

{unitpost-0.2.1 → unitpost-0.4.0}/README.md

@@ -43,15 +43,16 @@ Pass the key to `Unitpost(...)`, or set `UNITPOST_API_KEY`. Create a key at
 
 | Accessor | Covers |
 | --- | --- |
-| `emails` | Send, batch, list, get, update, stats, inbound (`received_*`) |
+| `email` | Send, batch, list, get, update, stats, inbound (`received_*`) |
+| `email.topics` | Topics + contact topic prefs |
+| `email.campaigns` | Draft, schedule, send, pause/resume |
+| `email.templates` | Template CRUD |
+| `email.domains` | Domains + verify |
+| `sms` | Send, get, list, `brands()`, `numbers()`, contact SMS consent. Available on paid plans: on the free plan `send` returns a `403` with code `limit_reached`, while the reads keep working. |
 | `contacts` | CRUD, import jobs |
 | `contact_fields` | Custom field definitions |
 | `segments` | Segments + membership |
-| `topics` | Topics + contact topic prefs |
-| `campaigns` | Draft, schedule, send, pause/resume |
-| `templates` | Template CRUD |
 | `brand_kits` | Brand kit |
-| `domains` | Domains + verify |
 | `webhooks` | Endpoints + `verify()` |
 | `api_keys` | API key management |
 | `suppressions` | Suppression list |
@@ -75,7 +76,7 @@ complaints are added automatically; you can also add your own:
 unitpost.suppressions.create({"email": "bounced@example.com", "reason": "manual"})
 unitpost.suppressions.create({"emails": ["a@example.com", "b@example.com"]})
 
-# Look one up by id or email; list (optionally filter scope); un-suppress.
+# Look one up by id or email; list your own; un-suppress.
 unitpost.suppressions.get("bounced@example.com")
 for s in unitpost.suppressions.list_all():
     print(s["email"], s["reason"])
@@ -104,9 +105,45 @@ Or from the client (Resend-style alias):
 event = client.webhooks.verify(payload=raw_body, secret=secret, headers=request.headers)
 ```
 
+## Receive a text and answer it
+
+US toll-free, 10DLC and Canadian numbers take replies (`two_way: True` on
+`sms.numbers()`). Subscribe a webhook to `sms.received`, skip STOP and texts
+Unitpost already answered, read the conversation with `participant`, and answer
+without `from` so the reply leaves from the number they texted.
+
+```python
+import os
+from unitpost import Unitpost, verify_webhook
+
+unitpost = Unitpost()  # reads UNITPOST_API_KEY
+
+# Your webhook endpoint, subscribed to sms.received. Pass the RAW body.
+def on_webhook(raw_body: bytes, headers: dict) -> None:
+    event = verify_webhook(
+        payload=raw_body,
+        secret=os.environ["UNITPOST_WEBHOOK_SECRET"],  # whsec_…
+        headers=headers,
+    )
+    if event["type"] != "sms.received":
+        return
+    reply = event["data"]
+    if reply["keyword"] == "OPT_OUT" or reply["auto_replied"]:
+        return  # STOP, or already answered
+
+    # The whole conversation with this person, both directions, newest first.
+    # Other filters: direction, status, from_ (sent as `from`), to, contact_id,
+    # campaign_id, created_after, created_before.
+    history = unitpost.sms.list(participant=reply["from"], limit=20)
+    answer = your_agent(history.data["data"], reply["body"] or "")
+
+    # No "from": the answer goes out from the number they texted.
+    unitpost.sms.send({"to": reply["from"], "body": answer})
+```
+
 ## Idempotency
 
-`emails.send` and `emails.batch` are safe to retry by default — if you don't pass
+`email.send` and `email.batch` are safe to retry by default — if you don't pass
 `idempotency_key`, the SDK generates one so an automatic retry can't double-send.
 Pass your own to dedupe across separate calls:
 
@@ -126,7 +163,7 @@ Transient failures are retried automatically: `429`, `5xx`, and transport errors
 `Retry-After` is honored; otherwise exponential backoff with full jitter is used.
 Client errors (`401`/`403`/`404`/`409`/`422`) are never retried. Only requests
 safe to replay are retried: `GET`s and writes carrying an idempotency key (which
-`emails.send` and `emails.batch` always do); any other keyless write is never
+`email.send` and `email.batch` always do); any other keyless write is never
 auto-retried.
 
 ```python
@@ -139,7 +176,8 @@ unitpost = Unitpost(max_retries=2, retry_base_delay=0.5, max_retry_delay=20.0)
 | | |
 | --- | --- |
 | Docs + API reference | https://www.unitpost.com/docs |
-| Product / SMTP / MCP guides | https://www.unitpost.com/guides |
+| Product guides | https://www.unitpost.com/guides |
+| SMTP | https://www.unitpost.com/docs/smtp |
 | OpenAPI JSON | https://www.unitpost.com/api/v1/openapi.json |
 | LLM index | https://www.unitpost.com/llms.txt |
 | Dashboard / API keys | https://www.unitpost.com |
@@ -147,7 +185,7 @@ unitpost = Unitpost(max_retries=2, retry_base_delay=0.5, max_retry_delay=20.0)
 | Template gallery | https://www.unitpost.com/templates/gallery |
 | Playground | https://www.unitpost.com/playground |
 | Migration Assistant | https://www.unitpost.com/migration |
-| MCP + Agent Skills | https://www.unitpost.com/guides#ai-mcp · https://www.unitpost.com/guides#ai-skills |
+| MCP + Agent Skills | https://www.unitpost.com/docs/ai/mcp · https://www.unitpost.com/docs/ai/skills |
 | Support | support@unitpost.com |
 
 ## License

{unitpost-0.2.1 → unitpost-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "unitpost"
-version = "0.2.1"
+version = "0.4.0"
 description = "Official Unitpost SDK for Python — send email and manage contacts, segments, campaigns, templates, brand kits, domains, suppressions, webhooks, and usage."
 readme = "README.md"
 requires-python = ">=3.8"

{unitpost-0.2.1 → unitpost-0.4.0}/src/unitpost/_client.py

@@ -29,7 +29,9 @@ from .resources import (
     Contacts,
     Email,
     Segments,
+    Sms,
     Suppressions,
+    Jobs,
     Usage,
     Webhooks,
 )
@@ -62,6 +64,9 @@ class Unitpost:
         )
         self._http = http
         self.email = Email(http)
+        # SMS channel. Available on paid plans: on the free plan `send` returns
+        # a 403 with code `limit_reached`; reads keep working.
+        self.sms = Sms(http)
         self.contacts = Contacts(http)
         self.contact_fields = ContactFields(http)
         self.segments = Segments(http)
@@ -71,6 +76,7 @@ class Unitpost:
         self.suppressions = Suppressions(http)
         # NOTE (pre-launch): `events` is intentionally absent while the
         # custom-events surface is behind the launch gate.
+        self.jobs = Jobs(http)
         self.usage = Usage(http)
 
     def close(self) -> None: