Knowledge Workshop Uploader

A tool created by James Cockbill to help upload knowledge documents via the File Ingestion API

Not for production use
Pick a region or choose Custom and enter your own API base URL.
This should be the API host for the org, such as api.mypurecloud.de.
Required when creating a new source. For file-upload workshops, use FileUpload.
Leave blank unless your org uses a connection-backed source.
Upload one or more files. They will be sent in a single synchronization round.

Quick Start Guide

What You Need

  • OAuth Credentials from Genesys Cloud (Client ID & Secret)
  • Your Region (e.g., US East, Europe, Australia)
  • Files to Upload (PDF, Word, Excel, Text, etc.)
    • Max 50MB per file
    • ⚠️ PowerPoint NOT supported

Steps to Upload

1. Select Your Region
Choose your Genesys Cloud region from the dropdown.

2. Enter Your Credentials
Paste your Client ID and Client Secret.

First time? Create OAuth credentials in Genesys Cloud:
Admin → Integrations → OAuth → Add Client
Grant Type: Client Credentials
Roles needed:

  • Knowledge > Source > All Permissions
  • Knowledge > Document > All Permissions

3. Choose Your Knowledge Source

Option A: Create New
Leave "Existing Knowledge Source ID" blank, enter a name, set Source Type to FileUpload

Option B: Use Existing
Paste your Knowledge Source ID (find in Genesys: Admin → Knowledge → Sources)

4. Select Files & Upload
Click Choose Files, select documents, then click Upload to Genesys

Common Issues

"Token request failed"
Check Client ID/Secret for typos, verify region is correct, ensure OAuth client has required roles

"Upload failed"
File must be under 50MB, PowerPoint not supported (convert to PDF), check file name (use only letters, numbers, hyphens, underscores)

"Could not start synchronization"
Verify Knowledge Source ID is correct, wait 2-3 minutes if someone else is uploading to the same source

Run status

Submit the form to see the API calls and results here.

Raw API responses

[]