Developers

UploadWithHubie API

Upload images from scripts, ShareX, browser extensions, Discord bots or your own app. Create an API key in your account settings, then send it as a Bearer token.

Authentication

Every request must include your key in the Authorization header:

Authorization: Bearer hubie_xxxxxxxxxxxxxxxx

Keys are shown once when created. Revoke a key at any time in settings.

POST /api/v1/upload

Send multipart/form-data with one or more files.

Field	Required	Description
files	required	One or more image files (multipart). Max 50 per request, 100 MB each.
albumId	optional	ID of one of your albums.
visibility	optional	public (default) or private.
nsfw	optional	1 or true to mark the upload as NSFW.
quality	optional	optimized (default) or max for minimal compression.

Example

curl -X POST https://uploadwithhubie.com/api/v1/upload \
  -H "Authorization: Bearer hubie_xxx" \
  -F "files=@photo.jpg" \
  -F "visibility=public" \
  -F "nsfw=0"

Response

{
  "images": [
    {
      "id": "aBcD1234",
      "directUrl": "https://uploadwithhubie.com/f/aBcD1234.jpg",
      "viewerUrl": "https://uploadwithhubie.com/i/aBcD1234",
      "thumbUrl": "https://uploadwithhubie.com/t/aBcD1234.webp",
      "markdown": "![photo.jpg](https://uploadwithhubie.com/f/aBcD1234.jpg)",
      "html": "<a href=\"...\"><img src=\"...\" alt=\"photo.jpg\" /></a>",
      "bbcode": "[img]https://uploadwithhubie.com/f/aBcD1234.jpg[/img]"
    }
  ],
  "failures": []
}

GET /api/v1/me

Returns your account details, storage usage and upload counts.

Limits & errors

• Up to 50 files per request, 100 MB per file.
• JPG, PNG, GIF and WEBP only.
• 120 requests per 10 minutes per key.
• Errors return { "error": "..." } with a 4xx status.

Create an API key ShareX setup

Hubie is working on it...