Skip to main content

Welcome to Hubsy Cloud API

The Hubsy Cloud API allows you to programmatically upload, download, manage, and share files from your applications. Build custom integrations, automate workflows, and create powerful file management solutions.

Getting Started

1

Get API Key

  1. Log in to your Hubsy Cloud account
  2. Go to Settings → API Keys
  3. Click “Generate New API Key”
  4. Copy and securely store your key
Never expose API keys in client-side code or public repositories.
2

Make Your First Request

Test your API key with a simple request:
3

Explore Endpoints

Check out our endpoint documentation below to see what’s possible.

Base URL

All API requests should be made to:

Authentication

Hubsy Cloud API uses Bearer token authentication. Include your API key in the Authorization header:

Example Request

API Key Scopes

Control what your API keys can access:
  • Read: View files and folders
  • Write: Upload and modify files
  • Delete: Remove files and folders
  • Share: Create and manage share links
Create separate API keys for different applications with minimum required permissions.

Rate Limits

To ensure service quality, API requests are rate limited:

Rate Limit Headers

Response headers indicate your current status:
When rate limit is exceeded, you’ll receive a 429 Too Many Requests response.

Response Format

All responses are in JSON format:

Success Response

Error Response

Common Error Codes

Pagination

List endpoints support pagination:

Request Parameters

  • page: Page number (default: 1)
  • per_page: Items per page (default: 50, max: 100)

Example Request

Response

Webhooks

Receive real-time notifications for events:

Available Events

  • file.uploaded - New file uploaded
  • file.deleted - File deleted
  • file.shared - File shared
  • share.accessed - Shared file accessed
  • storage.warning - Approaching storage limit

Setup

  1. Go to Settings → Webhooks
  2. Add webhook URL
  3. Select events to monitor
  4. Save configuration

Webhook Documentation

Learn more about webhooks

SDKs & Libraries

Official SDKs for popular languages:

JavaScript/Node.js

Python

PHP

Ruby

SDKs handle authentication, retries, and error handling automatically.

Quick Examples

Upload a File

List Files

Support

Need help with the API?

API Status

Check API uptime and incidents

Support

Contact API support team

Community

Join our developer community

Changelog

View API updates and changes

Next Steps

File Operations

List, upload, and manage files

Sharing

Create and manage share links