## Send Message

`groups.send_message(GroupSendMessageParams**kwargs)  -> MessageResponse`

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

Send a message to a group of recipients (beta feature)

### 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.

- `group_id: Optional[str]`

  Unique identifier for an existing group

- `media_url: Optional[str]`

  URL of media file to send

- `numbers: Optional[SequenceNotStr[str]]`

  Array of recipient phone numbers in E.164 format

### 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.groups.send_message(
    content="Hello, everyone!",
    from_number="+19998887777",
)
print(message_response.account_email)
```