Function create_buffer_post

social/scripts/buffer_utils.py:148–222

Create a Buffer post for a single channel via GraphQL. Args: access_token: Buffer API access token channel_id: Buffer channel ID to post to text: The post text content media: Optional media dict with key 'photo' or 'url' containing image URL metadata: Opt

(
    access_token: str,
    channel_id: str,
    text: str,
    media: Optional[Dict] = None,
    metadata: Optional[Dict] = None,
    scheduled_at: Optional[str] = None,
    now: bool = False,
)

# --- Post creation ---

def create_buffer_post(
    access_token: str,
    channel_id: str,
    text: str,
    media: Optional[Dict] = None,
    metadata: Optional[Dict] = None,
    scheduled_at: Optional[str] = None,
    now: bool = False,
) -> Dict:
    """Create a Buffer post for a single channel via GraphQL.

    Args:
        access_token: Buffer API access token
        channel_id: Buffer channel ID to post to
        text: The post text content
        media: Optional media dict with key 'photo' or 'url' containing image URL
        metadata: Optional per-platform metadata for Buffer GraphQL
        scheduled_at: Optional ISO 8601 timestamp for scheduling
        now: If True, post immediately (shareNow mode)

    Returns:
        Dict with success status. On success: {"success": True, "post": {...}}.
        On failure: {"success": False, "error": "..."}.
    """
    if scheduled_at:
        mode = "customScheduled"
    elif now:
        mode = "shareNow"
    else:
        mode = "addToQueue"

    post_input: Dict = {
        "channelId": channel_id,
        "text": text,
        "schedulingType": "automatic",
        "mode": mode,
    }

    if scheduled_at:
        post_input["dueAt"] = scheduled_at

    if metadata:
        post_input["metadata"] = metadata

    # Map media (REST used media[photo], GraphQL uses assets.images)
    if media:
        photos = media.get("photos")  # list of URLs (for carousel)
        if photos:
            post_input["assets"] = {
                "images": [{"url": u} for u in photos]
            }
        else:
            image_url = media.get("photo") or media.get("url")
            if image_url:
                post_input["assets"] = {
                    "images": [{"url": image_url}]
                }