REST is a very simple way of doing remote procedure calls via HTTP. It uses standard GET or POST URLs to send the request, and a simple XML block for the response. It's lightweight, simple, and easy to implement.  See examples.

You need an API Key to use the API.

GET URLs have a maximum data length, so be sure to use POST for long requests or requests that have binary data (like uploads).

This API is in the BETA stage, so please report all bugs and problems.

If you come up with something clever and cool, we'd love to hear about it and add a link on this page to your project.

The URL to use for your REST calls is http[s]://api.SmugMug.com/hack/rest/ for everything BUT POSTing uploads, which should go to http://upload.SmugMug.com/hack/rest/. If you run into problems, make sure you're querying to the right address!

Here's how a typical operation works:

• login (using SmugMug.login.withPassword, SmugMug.login.withHash, or SmugMug.login.anonymously)
• store the resulting SessionID temporarily for re-use with other methods. A Session lasts for 6 hours of inactivity.
• call other methods as needed
• SmugMug.logout (which destroys your Session)

Finally, this API (and the others) are continously expanding. Please contact us if we're missing a method you'd like to see.

NOTE: Everything in the hacks section is provided "as-is" unless you specifically have a contract with SmugMug. They're not supported, endorsed, or guaranteed in any way. We'd love to fully support the API and other goodies with SmugMug's AAA customer service, but we're just not there yet. Soon, we hope.