## Send

`messages.send(MessageSendParams**kwargs)  -> MessageResponse`

**post** `/api/send-message`

Send an iMessage, SMS, or MMS to a single recipient

### Parameters

- `content: str`

  Message text content

- `from_number: str`

  **REQUIRED** - The phone number to send from. Must be one of your registered Sendblue phone numbers in E.164 format.
  Without this parameter, the message will fail to send.

- `number: str`

  Recipient phone number in E.164 format

- `media_url: Optional[str]`

  URL of media file to send (images, videos, etc.)

- `send_style: Optional[Literal["celebration", "shooting_star", "fireworks", 10 more]]`

  The iMessage expressive message style

  - `"celebration"`

  - `"shooting_star"`

  - `"fireworks"`

  - `"lasers"`

  - `"love"`

  - `"confetti"`

  - `"balloons"`

  - `"spotlight"`

  - `"echo"`

  - `"invisible"`

  - `"gentle"`

  - `"loud"`

  - `"slam"`

- `status_callback: Optional[str]`

  Webhook URL for message status updates

### Returns

- `class MessageResponse: …`

  - `account_email: Optional[str]`

    Email of the account that sent the message

  - `content: Optional[str]`

    Message content

  - `date_created: Optional[datetime]`

    When the message was created

  - `date_updated: Optional[datetime]`

    When the message was last updated

  - `error_code: Optional[int]`

    Numeric error code if message failed

  - `error_message: Optional[str]`

    Error message if message failed

  - `from_number: Optional[str]`

    Sending phone number

  - `is_outbound: Optional[bool]`

    Whether this is an outbound message

  - `media_url: Optional[str]`

    URL of attached media

  - `message_handle: Optional[str]`

    Unique identifier for tracking the message

  - `number: Optional[str]`

    Recipient phone number

  - `send_style: Optional[Literal["celebration", "shooting_star", "fireworks", 10 more]]`

    The iMessage expressive message style

    - `"celebration"`

    - `"shooting_star"`

    - `"fireworks"`

    - `"lasers"`

    - `"love"`

    - `"confetti"`

    - `"balloons"`

    - `"spotlight"`

    - `"echo"`

    - `"invisible"`

    - `"gentle"`

    - `"loud"`

    - `"slam"`

  - `status: Optional[Literal["QUEUED", "SENT", "DELIVERED", "ERROR"]]`

    - `"QUEUED"`

    - `"SENT"`

    - `"DELIVERED"`

    - `"ERROR"`

### Example

```python
import os
from sendblue_api import SendblueAPI

client = SendblueAPI(
    api_key=os.environ.get("SENDBLUE_API_API_KEY"),  # This is the default and can be omitted
    api_secret=os.environ.get("SENDBLUE_API_API_SECRET"),  # This is the default and can be omitted
)
message_response = client.messages.send(
    content="Hello, World!",
    from_number="+19998887777",
    number="+19998887777",
)
print(message_response.account_email)
```