Overview
This node integrates with the GetTranscribe API, enabling users to manage transcription-related resources such as transcriptions, folders, and user information. Specifically, the Folder - Create operation allows users to create a new folder within their transcription workspace. This is useful for organizing transcriptions into hierarchical structures, such as categorizing by project, client, or topic.
Common scenarios:
- Automatically creating folders to organize transcriptions generated from different video sources.
- Structuring transcription data in nested folders by specifying parent folder IDs.
- Managing transcription projects by grouping related transcriptions under dedicated folders.
Practical example:
You have a workflow that transcribes videos from various social media platforms. Before starting the transcription, you create a folder named "Marketing Campaign Q2" to keep all related transcriptions organized. Optionally, you specify a parent folder ID if this new folder should be nested inside an existing folder.
Properties
| Name | Meaning |
|---|---|
| Folder Name | The name of the folder to create. |
| Parent Folder ID | (Optional) The ID of the parent folder under which this new folder will be created. Use this to create subfolders. |
Output
The node outputs JSON data representing the newly created folder object returned by the GetTranscribe API. This typically includes details such as the folder's unique ID, name, parent folder ID (if any), creation timestamps, and other metadata provided by the API.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the GetTranscribe API.
- Needs an API authentication token configured in n8n credentials to authorize requests.
- The base URL used for API calls is
https://api.gettranscribe.ai. - The node uses HTTP POST requests with JSON payloads to create folders.
Troubleshooting
Common issues:
- Missing or invalid API authentication token will cause authorization errors.
- Providing an invalid or non-existent parent folder ID may result in API errors.
- Network connectivity issues can prevent successful API communication.
Error messages:
"Unauthorized"or"Authentication failed": Check that the API key credential is correctly set up and valid."Invalid parent folder ID"or similar: Verify that the specified parent folder exists."Request failed"or timeout errors: Ensure network connectivity and API availability.
Resolution tips:
- Double-check input parameters, especially the folder name and parent folder ID.
- Confirm API credentials are current and have necessary permissions.
- Retry after network issues are resolved.
Links and References
- GetTranscribe API Documentation (hypothetical link)
- n8n Documentation on Creating Custom Nodes
- ISO 639-1 Language Codes (relevant for transcription language settings)