## Send

`send_carousel.send(SendCarouselSendParams**kwargs)  -> SendCarouselSendResponse`

**post** `/api/send-carousel`

Send a carousel of images to a single recipient. Requires a V2 (Mac Mini) line. The carousel must contain between 2 and 20 HTTPS image URLs. For sending a single image, use `/api/send-message` with `media_url` instead.

### Parameters

- `from_number: str`

  Your Sendblue phone number in E.164 format (must be a V2/Mac Mini line)

- `media_urls: SequenceNotStr[str]`

  Array of HTTPS image URLs to send as a carousel (2-20 items)

- `number: str`

  Recipient phone number in E.164 format

- `metadata: Optional[object]`

  Additional metadata to attach to the message

- `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 SendCarouselSendResponse: …`

  - `account_email: Optional[str]`

    Email of the account that sent the message

  - `from_number: Optional[str]`

    Sending phone number

  - `is_outbound: Optional[bool]`

  - `media_url: Optional[str]`

    First media URL from the carousel

  - `message_handle: Optional[str]`

    Unique identifier for tracking the message

  - `message_type: Optional[str]`

  - `number: Optional[str]`

    Recipient phone number

  - `status: Optional[str]`

### 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
)
response = client.send_carousel.send(
    from_number="+19998887777",
    media_urls=["https://example.com/image1.jpg", "https://example.com/image2.jpg", "https://example.com/image3.jpg"],
    number="+19998887777",
)
print(response.account_email)
```