Publish from your phone

The Sitepaste API works from anything that can make an HTTP request, including the Shortcuts app on iPhone and Mac. That makes it possible to write a post in Apple Notes and publish it without opening a browser.

Publishing this way requires an API token, which is a Pro plan feature. Create one in the dashboard under Account > Tokens.

Apple Notes shortcuts

Sitepaste maintains step-by-step instructions for two shortcuts in the integrations repository:

  • Publish Note to Sitepaste: pick a recent note, choose blog, docs, or standalone, and publish it. Running it again on the same note updates the existing page.
  • Publish Folder to Sitepaste: publish every note in a Notes folder with one content type, the way the GitHub Action publishes a directory.

A few things to know about Notes as a writing surface:

  • Shortcuts extracts note content as plain text, so rich-text formatting is lost. Write Markdown syntax directly in your notes and it renders properly on your site.
  • Images embedded in notes can’t be extracted by Shortcuts. Upload them through the dashboard or the media API and reference them by URL.

Roll your own shortcut

If you don’t use Apple Notes, the recipe is one “Get Contents of URL” action:

  1. URL: https://sitepaste.com/api/v1/public/pages, method POST.
  2. Header Authorization with value Bearer sp_your_token_here.
  3. A JSON request body with title and content fields, filled from “Ask for Input” actions.

The slug is generated from the title, and the page is created as a blog post unless you add a contentType field. Add a second “Get Contents of URL” action posting to https://sitepaste.com/api/v1/public/builds (same header, no body) to deploy the site afterwards.

That’s enough for quick posts, link posts with commentary, or notes you want on your site the moment you think of them. The request can also set sections, drafts, tags, and a target site. See the pages reference for everything it can do.