Pictures and video
The Buzzmark API takes a picture or video 3 ways: an upload from your code, a copy from a public https link, or a picture Buzzmark's image model makes in your brand's colours.
Every file gets the app's checks and is kept in Buzzmark's own storage and your Library, so a post never depends on the link it came from.
Upload a file
1. Send
POST /media/upload-urlwith the file's name, such asspring-menu.jpg. The answer has anupload_url, the header to send and anupload_id.2.
PUTthe file's bytes toupload_urlwith exactly thatContent-Typeheader and nothing else.3. Send
POST /media/from-uploadwith theupload_id, and apost_idto put it on a draft.
The upload link and its id work for 55 minutes.
Copy a file from a link
A file already on the web goes in one step: POST /media/from-url with a public https link straight to the file. Buzzmark keeps its own copy. A link to a private or local address, a page instead of a file, or a file over its size is refused, and nothing is kept.
Have Buzzmark make a picture
POST /images takes a description and makes a picture in the brand's colours, marked Made with AI in the Library. Name a product exactly as the brand profile lists it, and its own photo is the reference. It takes about a minute and uses one of your plan's pictures for the month; a picture that's refused or fails isn't counted.
On a draft
With a post_id, every way in adds the file to that draft and answers what a platform on it would refuse, such as a shape Instagram doesn't take. In a thread, part picks the post, from 0. Alt text isn't taken yet. Pictures and video has each platform's rules.
| Endpoint | Request | Needs |
|---|---|---|
| Get an upload link for a file | POST /api/v1/media/upload-url | Draft |
| Keep an uploaded file | POST /api/v1/media/from-upload | Draft |
| Add a picture or video from a link | POST /api/v1/media/from-url | Draft |
| Make a picture | POST /api/v1/images | Draft |
Where to next
- Check and schedule posts
POST /posts/validate checks a post against each account's platform rules and saves nothing; POST /posts and POST /posts/bulk run the same check, then schedule.
- Buzz writing
Buzz's writing tools are on the Buzzmark API: write posts, rewrite one, check it against your brand's voice with a score from 0 to 100, adapt it for each platform, find post ideas and read what worked this month.
- Pictures and video
A Buzz takes JPG, PNG, WebP or GIF pictures up to 10 MB and MP4 or MOV video up to 1 GB, and a video always goes out on its own.
- Endpoints
Every endpoint of the Buzzmark REST API, with its method and path, the key scope it needs, its inputs and a curl example to copy into code, n8n or Make.