Create a gallery

Create an empty gallery in a folder, Private unless you say otherwise.

POST https://cotlet.dev/api/v1/smugmug/galleries

write

Creates the gallery with the settings of the Create Gallery form and returns its ID and link. The gallery is empty and notifies no one, so it needs no confirmation. Change who can see it later with set_gallery_privacy. Creating a gallery in a Private folder keeps it Private.

Parameters

Parameters: create_gallery
NameTypeDescription
title string required string Gallery title.
folder_id string string Folder ID from list_galleries. Leave out to create it at the top of your site.
description string string Gallery description.
visibility string string One of 'private' (default), 'unlisted' or 'public'.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/smugmug/galleries \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"title"}'
Python
result = client.call("smugmug", "create_gallery", {"title":"title"})
Node.js
const result = await cotlet.call('smugmug', 'create_gallery', {"title":"title"});
CLI
cotlet call smugmug create_gallery --data '{"title":"title"}'

Example response

JSON

{
  "gallery_id": "Xk4RtP",
  "title": "Smith wedding",
  "folder_id": "Hm3vLq",
  "visibility": "private",
  "web_url": "https://studio.smugmug.com/Delivered-2026/Smith-wedding"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.