# pCloud Setup: Connect & Transfer Files

> How to connect Blober to pCloud. Browse folders, upload and download files, and transfer between pCloud and other cloud providers.

pCloud is a cloud storage service with US and EU data centers. In Blober you browse your pCloud by navigating the folder tree. pCloud doesn't support path-based access, so you pick a folder or the whole account as a source or destination.

## Intended Capabilities

* ✅ Browse folders and files
* ✅ Upload files
* ✅ Download files
* ✅ Create folders (created automatically when uploading)
* ✅ Delete files and folders (folders recursively)
* ✅ Copy files within pCloud
* ✅ Move files within pCloud

## Prerequisites

* A [pCloud account](https://www.pcloud.com/) (free or paid)
* No pCloud app needed to get started. The **App Key** and **App Secret** are pre-filled with Blober's registered pCloud app, so you can authorize right away. Prefer your own app? See [Create a pCloud App](#1-create-a-pcloud-app).

[]()

## Authentication

Blober connects to pCloud using your app's **App Key** and **App Secret** via the OAuth 2.0 authorization-code flow.

**Credential fields:**

| Field          | Description                                     | Default                        |
| -------------- | ----------------------------------------------- | ------------------------------ |
| **App Key**    | Your pCloud app key (short alphanumeric string) | `c07tF0mXr10`                  |
| **App Secret** | The secret paired with your app key             | `NjSmWPr0IuJDzmIDXdLGijP6gTDV` |

#### Default: Blober's registered pCloud app

The **App Key** and **App Secret** fields are pre-filled with the credentials of a pCloud app registered by [Blober](https://blober.io/) (shown as `Blober - Cloud File Migration` during authorization). This is the fastest option - you authorize in seconds with no app setup or review wait.

Prefer the open-source [rclone](https://rclone.org/) app instead? Its public keys are still supported - replace the pre-filled values with:

| Credential     | Value                          |
| -------------- | ------------------------------ |
| **App Key**    | `DnONSzyJXpm`                  |
| **App Secret** | `RUqH9GooHqkC4IFkifsD1haRu9fy` |

These are rclone's real public keys, verifiable in its [pCloud backend](https://github.com/rclone/rclone/blob/aba403fa79ea8f4fc9a9e2cbe4c333412e0eb257/backend/pcloud/pcloud.go#L40-L41) source (`rcloneClientID` and the obfuscated `rcloneEncryptedClientSecret`).

#### Setup steps

With the pre-filled keys you can skip app creation entirely:

1. In Blober, go to **Workflows** => **New Workflow**
2. Select **pCloud** as source or destination
3. Keep the pre-filled **App Key** and **App Secret**, or paste rclone's keys from above
4. Click **Authorize pCloud Access** - a browser window opens for consent
5. Sign in with your pCloud account and grant permissions
6. The browser redirects back to Blober automatically and you're connected

> **Note**
>
> With Blober's or rclone's pre-filled keys, no redirect URI needs to be registered on pCloud's side - Blober handles the local callback itself. If you register your own pCloud app instead, add the redirect URI shown in [Create a pCloud App](#1-create-a-pcloud-app).

## Setup Guide

### 1. Create a pCloud App

Only needed if you prefer not to use Blober's pre-filled keys (rclone's public keys from the table above are another no-setup alternative).

1. Sign in to the [pCloud App Console](https://docs.pcloud.com/my_apps/) and select **Create app** (or **New app**)
2. Fill in the app details as below
3. Save the app
4. Copy the **Client ID** and **Client secret** it generates - these become your **App Key** and **App Secret** in Blober

The console asks for a few details. Values that work for connecting Blober:

| Field                    | Suggestion                                                                          |
| ------------------------ | ----------------------------------------------------------------------------------- |
| **App name**             | `Blober - Cloud File Migration` (any name you'll recognize)                         |
| **Publisher**            | `Blober` (or the name you publish under)                                            |
| **Description**          | `Desktop app that transfers files between pCloud and other cloud or local storage.` |
| **Redirect URIs**        | `http://localhost:52847/oauth/pcloud/callback`                                      |
| **Website**              | `https://blober.io`                                                                 |
| **Allow implicit grant** | **Disallow** - Blober uses the authorization-code flow only                         |

**App icon** (optional): must be **64 x 64** px. Use Blober's logo if you want it to match the brand.

#### Add the redirect URI

Blober's callback runs on that exact local address, so your app must allow it: `http://localhost:52847/oauth/pcloud/callback`

The **Redirect URIs** field accepts `http://localhost` addresses. Blober's own app and rclone's app already register the callback Blober uses, so this step applies only to apps you create yourself.

> **App review**
>
> pCloud reviews apps to check security and compliance, so a new app may show as **Pending review** before it is approved. This does not block connecting it in Blober.

## Data Centers

pCloud runs two data centers: **US** (`api.pcloud.com`) and **EU** (`eapi.pcloud.com`). The authorization redirect identifies the account's data center.

## File Organization

pCloud has no path-based API. Blober resolves paths by walking the folder tree from the root (`folderid 0`) and matching folder names, creating missing folders automatically when uploading.

* Names are **case-sensitive** (unlike Box or Google Drive), so `Photos` and `photos` are different folders
* A file and a folder may share the same name in one folder
* Folders are created automatically when uploading to a path that doesn't exist yet

## How Uploads Work

* Files are uploaded to pCloud in a single request. Account, server, and connection limits apply - pCloud publishes no universal maximum file size.
* **Overwrite-first:** if a file already exists at the destination, it is replaced with the new version.
* Parent folders are created automatically if they don't exist.

## Access Tokens Never Expire

pCloud documents no scheduled expiry for access tokens. A token can still become invalid when access is revoked or pCloud rejects the login.

Access is revocable only from your pCloud account settings. If you ever see a "Log in failed" error, the app was revoked - remove the connection in Blober and authorize again.

## Rate Limiting

pCloud classifies 4xxx results as rate limiting and 5xxx results as temporary server failures. Blober retries these automatically.

## Troubleshooting

### "Log in failed" errors

* The app was revoked from your pCloud account settings. Remove the connection in Blober and authorize again.

### Authentication failed / Permission denied

* Ensure the App Key and App Secret belong to the same app and are entered correctly, with no leading/trailing whitespace.

### Files not appearing

* Refresh the file list in Blober.
* Check the files exist in your pCloud account (in the correct data center region).

### Uploads failing mid-way

* If an upload fails, start it again - Blober retries the file from the beginning. Your existing file at the destination is not lost.

### How to revoke access

1. Go to your [pCloud account settings](https://my.pcloud.com/#/settings?settings=tab-apps) and find **Linked Accounts**
2. Remove the Blober app
3. In Blober, remove the existing connection

Revoking access invalidates the token immediately.

## Limitations

* **No path-based API**: Blober walks the folder tree, so paths resolve by folder name.
* **No resumable uploads**: each file uploads in a single request; a failure retries the whole file.
* **Case-sensitive names**: migrating from a case-insensitive provider may create duplicate-looking folders.
* **Filename rules**: UTF-8 names up to 1024 bytes; only `/`, `\`, and NULL are forbidden.

> **Terms Compliance**
>
> Your use of pCloud through Blober is subject to [pCloud's Terms of Service](https://www.pcloud.com/terms.html). See our [Terms of Service](/kb/docs/terms-and-privacy/terms-of-service/) for details.