ShareX Integration

PicFast provides built-in ShareX support. ShareX is a free, open-source screenshot and file upload tool for Windows.

One-click setup

First, create an API token in Settings → API Tokens (or use an existing one — tokens are shown only once when created, so save it). Then go to Connections, fill in or select your token, and download the personalized ShareX config file. In ShareX: Destinations → Import → from file.

The downloaded config includes your API token and server URL — no manual setup required. The same token also works for copying configs of other tools on the Connections page.

Manual setup

If you prefer to configure manually, create a new Custom uploader in ShareX:

Request settings

FieldValue
Request URLhttps://picfast.example.com/api/v1/sharex/upload
Request methodPOST
Bodymultipart/form-data
File form namefile
Argument namekey
Argument valueLeave empty
HeadersAuthorization: Bearer YOUR_TOKEN

Response settings

FieldValue
Response typeJSON
URLjson:$.url
Thumbnail URLjson:$.thumbnail_url

Verify

Take a screenshot or upload a file in ShareX. The image URL should appear in your clipboard automatically. By default, the Markdown-formatted link is also available.

Troubleshooting

  • Make sure server.base_url is set to your actual domain. The ShareX config generator uses this value to construct request URLs.
  • If uploads time out, check your reverse proxy's client_max_body_size — it should be at least as large as your per-group upload limit.
  • Verify your API token is still valid. Tokens can be rotated in the PicFast UI under Settings.