WHAT THIS DOES
This feature allows you to upload or register Files in MOBLE from another platform. Ideal for teams managing documents, PDFs, or images in a shared drive or spreadsheet, it keeps your assets organised and up to date without manually uploading each file.
COMMON USE CASES
- Sync your marketing brochures, price lists, or product sheets from Google Drive or Airtable into MOBLE automatically.
- Keep your file library current with new uploads or replaced assets managed by your content team.
- Upload seasonal or campaign materials quickly using the CSV import option.
HOW IT WORKS
- Each row in your Sheet or Airtable represents one file record.
- The n8n Workflow Template checks for new or updated rows and sends those file details (or URLs) to MOBLE.
- MOBLE either uploads the file (if provided as Base64) or links the external file URL to your site library.
- You can find the n8n Template, CSV upload, and API documentation next to “Files” in the Add Knowledge area of MOBLE.
SETUP (OFFICE MANAGER)
1. Download the n8n Template
- In MOBLE → Add Knowledge → Files, click the n8n Template button.
- Open it in your n8n workspace (free or cloud version).
2. Connect Your Data Source
- Replace the example Google Sheets node with your own Sheet, or connect to your Airtable Base.
- Ensure columns match MOBLE fields (for example: file_name, url, description, folder).
- Optionally, include Base64 file data for direct uploads.
3. Add MOBLE API Credentials
- In n8n → Credentials → add HTTP Header Auth.
- Name: Authorization
- Value: Bearer ak_XXXXXXXX (find your key in MOBLE → Settings → API).
4. Run and Verify
- Run the workflow once to test the upload or link connection.
- Check MOBLE → Files to confirm the new file has appeared.
- Activate the workflow to enable automatic syncing of new or updated files.
5. Optional: CSV Upload
- Use the CSV Upload button in Add Knowledge → Files to upload multiple records at once.
- CSV uploads are perfect for adding large collections or new marketing materials in bulk.
- Note: CSV uploads do not sync automatically; they are one-time imports.
COMMON FIELD MAPS
- file_name — The file’s display name in MOBLE.
- url — Direct link to a hosted file (Drive, Dropbox, etc.).
- base64 — Encoded binary data for uploading files directly to MOBLE.
- description — Optional description or notes about the file.
- folder — Optional folder label for grouping within MOBLE.
- tags — Comma-separated keywords for AI and internal search.
- status — draft or published (optional).
TIPS FOR NON-DEVELOPERS
- The n8n Template already includes the correct API calls; you just connect your source and key.
- If you prefer not to use n8n, developers can connect via the API directly — it uses /api/site/files to create or update files.
- All file links must be public if you’re referencing external storage like Google Drive.
- For Base64 uploads, ask your developer for help if you need to automate from a local folder or internal system.
TROUBLESHOOTING
- No file uploaded: Check that either url or base64 is included.
- 401 error: API key missing or invalid — verify in n8n Credentials.
- 415 unsupported type: Ensure only valid file types (PDF, PNG, JPG, DOCX, etc.) are used.
- CSV didn’t sync: CSV uploads are manual imports only.
SECURITY: Use dedicated API keys for file automation and rotate quarterly. Avoid linking sensitive files from unprotected drives.