Skip to content
Sendblue Docs
Get Started
API Reference
Media Objects

Upload a media object

media_objects.upload(MediaObjectUploadParams**kwargs) -> MediaObjectUploadResponse
post/api/upload-media-object

Upload a media file to Sendblue's CDN for use in messages

ParametersExpand Collapse
media_url: str

URL of the media file to upload

formaturi
ReturnsExpand Collapse
class MediaObjectUploadResponse: …
media_object_id: Optional[str]
message: Optional[str]
status: Optional[str]
Upload a media object
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.media_objects.upload(
    media_url="https://example.com/image.jpg",
)
print(response.media_object_id)
{
  "mediaObjectId": "abc123def456",
  "message": "File uploaded successfully",
  "status": "OK"
}
Returns Examples
{
  "mediaObjectId": "abc123def456",
  "message": "File uploaded successfully",
  "status": "OK"
}