PicGo Integration

Configure PicGo to upload images directly to Picora using the built-in Custom Web Uploader plugin.

Prerequisites

• PicGo installed (download)
• A Picora account with an API key (see Quick Start)

Configuration Steps

1. Open PicGo Settings

Launch PicGo and click the “Image Host Settings” icon in the left sidebar, then select “Custom Web Uploader” from the list.

2. Enter the API Configuration

Fill in the following fields exactly as shown:

Field	Value
API URL	https://api.picora.com/v1/images
Request Method	POST
Request Header	{"Authorization": "Bearer sk_live_YOUR_KEY"}
Upload Field Name	file
Response URL Path	data.url

Replace sk_live_YOUR_KEY with your actual API key from the Picora dashboard.

3. Set Custom Web Uploader as Default

Click “Set as Default Image Host” to make Picora the default uploader for all future screenshots and drag-and-drop uploads.

4. Test the Connection

Click the “Test” button (or drag an image onto the PicGo window). If configured correctly, you’ll see a success message and the image URL will be copied to your clipboard.

How It Works

When you upload through PicGo:

1. PicGo sends a POST request to https://api.picora.com/v1/images with your image as multipart form data
2. Picora stores the image on Cloudflare R2 and registers it in your account
3. PicGo reads data.url from the response — your permanent CDN URL
4. The URL is automatically copied to your clipboard, ready to paste into your Markdown editor

Troubleshooting

Upload fails with “Unauthorized”: Check that your API key starts with sk_live_ and is entered correctly in the Authorization header without extra spaces.

Upload fails with “Quota exceeded”: You’ve reached your plan’s storage limit. View your usage in the dashboard or upgrade your plan.

URL not copied to clipboard: Make sure the “Response URL Path” is set to exactly data.url (case-sensitive).