Notion audio block from a Sume music URL: the extension check

You can add a Sume track to a Notion page as an audio block with an external URL, but Notion documents the accepted file extensions: .mp3, .wav, .ogg, .oga and .m4a. Sume's Music Router returns the audio as an artifact, usually audio/mpeg, on media.sume.com. Look at the URL path first. If it does not end in one of those extensions, upload the file through Notion's File Upload API instead of linking it.

What Notion documents

The block reference describes the audio block and the rule for external files.

Create the block

A Music Router job costs a fixed $0.125 and returns the file in result.artifacts[] with type audio. Read the URL from the job result, test the path, and only then append the block to the page.

import json, os, urllib.request
from urllib.parse import urlparse

OK = (".mp3", ".wav", ".ogg", ".oga", ".m4a")

def add_audio(page_id: str, url: str) -> None:
    if not urlparse(url).path.lower().endswith(OK):
        raise ValueError("extension not in Notion's list: use File Upload")
    body = {"children": [{"object": "block", "type": "audio",
            "audio": {"type": "external", "external": {"url": url}}}]}
    req = urllib.request.Request(
        "https://api.notion.com/v1/blocks/%s/children" % page_id,
        data=json.dumps(body).encode(), method="PATCH",
        headers={"Authorization": "Bearer " + os.environ["NOTION_TOKEN"],
                 "Notion-Version": os.environ["NOTION_VERSION"],
                 "Content-Type": "application/json"})
    urllib.request.urlopen(req, timeout=10).read()

Why the check is worth it

The rule is about the file name in the link, not the bytes. A URL can serve a valid mp3 and still fail a name-based test. Sume does not promise a specific file name or extension for artifacts, so treat the name as something to inspect. The NOTION_VERSION value is read from the environment in the sample because the header value belongs to your integration setup; use the version your integration targets.

Limits

An external link is not a copy. If the track must outlive the source URL, download it and upload it through Notion, and keep the Sume job id beside it for provenance. Notion's page does not state a size limit for external audio; do not invent one in your own docs.

Before you ship

None of this needs a Sume webhook: poll the job envelope until it says terminal, or use webhook mode and add the block from your receiver once the job completes.

• Check the artifact URL path before you create the block.
• Keep the job id in a Notion property.
• Use the File Upload route when the URL has no audio extension.
• Do not store the API key in a Notion property.