Build SDK

Stainless-Generated-From: a43eb58ed698395c426040da5f2d9b2fa5b2d3f2

Author: stlc-bot

src/sent_dm/resources/me.py

@@ -74,6 +74,17 @@ def retrieve(
         `rcs`. Each channel has a `configured` boolean. Configured channels expose
         additional details such as `phone_number`.
 
+        **Sending number:** `sending_phone_number` is the account's US SMS sender. It is
+        intentionally the same value as `channels.sms.phone_number` — the two are kept
+        in step, and it is published under both names because `sending_phone_number` is
+        what this value is called on `GET /v3/profiles`. Read either. One difference:
+        `sending_phone_number` is always present, including as `null`, while
+        `channels.sms.phone_number` is omitted when there is no sender.
+
+        `sending_phone_number_profile_id` names the account that holds that number in
+        inventory — normally this account, and a different one where a number is shared.
+        Both are `null` when the account has no US SMS sender.
+
         Args:
           extra_headers: Send extra headers
 
@@ -147,6 +158,17 @@ async def retrieve(
         `rcs`. Each channel has a `configured` boolean. Configured channels expose
         additional details such as `phone_number`.
 
+        **Sending number:** `sending_phone_number` is the account's US SMS sender. It is
+        intentionally the same value as `channels.sms.phone_number` — the two are kept
+        in step, and it is published under both names because `sending_phone_number` is
+        what this value is called on `GET /v3/profiles`. Read either. One difference:
+        `sending_phone_number` is always present, including as `null`, while
+        `channels.sms.phone_number` is omitted when there is no sender.
+
+        `sending_phone_number_profile_id` names the account that holds that number in
+        inventory — normally this account, and a different one where a number is shared.
+        Both are `null` when the account has no US SMS sender.
+
         Args:
           extra_headers: Send extra headers
 

src/sent_dm/types/inbound_message_event_payload.py

@@ -13,24 +13,24 @@ class InboundMessageEventPayload(BaseModel):
     Delivered when a contact messages one of your numbers.
     """
 
+    inbound_number: str
+    """The contact's number in E.164 format, meaning the number the message came from."""
+
+    received_at: str
+    """When the message was received, in UTC (yyyy-MM-ddTHH:mm:ssZ)."""
+
     account_id: Optional[str] = None
     """The account the message belongs to."""
 
     channel: Optional[str] = None
     """The channel the message arrived on, for example sms or whatsapp."""
 
-    inbound_number: Optional[str] = None
-    """The contact's number in E.164 format, meaning the number the message came from."""
-
     message_id: Optional[str] = None
     """The inbound message."""
 
     outbound_number: Optional[str] = None
     """Your number in E.164 format, meaning the number the message was addressed to."""
 
-    received_at: Optional[str] = None
-    """When the message was received, in UTC (yyyy-MM-ddTHH:mm:ssZ)."""
-
     text: Optional[str] = None
     """The message body.
 

src/sent_dm/types/me_retrieve_response.py

@@ -242,6 +242,30 @@ class Data(BaseModel):
     types)
     """
 
+    sending_phone_number: Optional[str] = None
+    """The SMS sender this account sends from in the United States, in E.164 form.
+
+    Null when the account has no US SMS sender.
+
+    The same value as channels.sms.phone_number, published under both names on
+    purpose: sending_phone_number is what this value is already called on GET
+    /v3/profiles, so the same key answers the same question whichever of the two
+    endpoints you ask. Neither name is preferred over the other and neither is
+    deprecated.
+
+    The same value, not the same presence: this key is always written, including as
+    null, whereas channels.sms.phone_number is left out entirely when there is no
+    sender.
+    """
+
+    sending_phone_number_profile_id: Optional[str] = None
+    """
+    The account that holds sending_phone_number in number inventory: normally this
+    account itself, and a different account when the number is held elsewhere. Null
+    when there is no US sender, or when the sender is not a number drawn from
+    inventory — an alphanumeric sender ID or a short code.
+    """
+
     settings: Optional[DataSettings] = None
     """Profile configuration settings"""
 

src/sent_dm/types/message_event_payload.py

@@ -14,6 +14,13 @@ class MessageEventPayload(BaseModel):
     message produces several of these as it moves toward a terminal status.
     """
 
+    message_status: str
+    """The status the message just reached, for example SENT, DELIVERED, or FAILED.
+
+    Sent means dispatched and delivered means confirmed, so treat them as distinct
+    outcomes.
+    """
+
     account_id: Optional[str] = None
     """The account the message belongs to."""
 
@@ -33,13 +40,6 @@ class MessageEventPayload(BaseModel):
     them.
     """
 
-    message_status: Optional[str] = None
-    """The status the message just reached, for example SENT, DELIVERED, or FAILED.
-
-    Sent means dispatched and delivered means confirmed, so treat them as distinct
-    outcomes.
-    """
-
     outbound_number: Optional[str] = None
     """The recipient's number in E.164 format."""
 

src/sent_dm/types/template_event_payload.py

@@ -14,6 +14,15 @@ class TemplateEventPayload(BaseModel):
     react without polling.
     """
 
+    status: str
+    """The review status the template just reached, for example APPROVED or REJECTED."""
+
+    whatsapp_template_id: str
+    """
+    The template's identifier with Meta, assigned when the template is submitted for
+    review.
+    """
+
     account_id: Optional[str] = None
     """The account the template belongs to."""
 
@@ -32,17 +41,8 @@ class TemplateEventPayload(BaseModel):
     Populated on a rejection.
     """
 
-    status: Optional[str] = None
-    """The review status the template just reached, for example APPROVED or REJECTED."""
-
     template_id: Optional[str] = None
     """The template in Sent."""
 
     template_name: Optional[str] = None
     """The template's display name."""
-
-    whatsapp_template_id: Optional[str] = None
-    """
-    The template's identifier with Meta, assigned when the template is submitted for
-    review.
-    """