N8N Tools - Typebot API
Complete Typebot.io integration - Self-hosted chatbot builder with visual flows
Actions23
- Typebot Actions
- Chat Actions
- Result Actions
- Workspace Actions
Overview
This node operation generates a secure upload URL for file uploads within the Typebot chat environment. It is useful when you want to allow users or systems interacting with a chatbot to upload files directly to a storage service without exposing direct access credentials. The generated URL typically has constraints such as file size limits and optional custom filenames.
Practical scenarios include:
- Allowing users in a chatbot session to upload images, documents, or other files.
- Preparing an upload endpoint dynamically before sending it to a client application.
- Enforcing file size restrictions and naming conventions on uploaded files.
Properties
| Name | Meaning |
|---|---|
| Additional Fields | Collection of optional parameters to customize the upload URL generation: |
| - Filename | Custom filename to assign to the uploaded file. |
| - File Size Limit MB | Maximum allowed file size in megabytes for the upload (default is 10 MB). |
Output
The output JSON contains the response from the Typebot API that includes the generated upload URL and any related metadata needed to perform the file upload. This URL can be used by clients to upload files securely.
The exact structure depends on the API response but generally includes:
- A signed URL or endpoint for uploading.
- Possibly headers or tokens required for the upload request.
- Expiration time or usage limits for the URL.
No binary data is output by this node operation.
Dependencies
- Requires an API key credential for authenticating with the Typebot API.
- Needs the base API URL and an authentication token configured in the node credentials.
- The node sends requests through a proxy service hosted at
https://n8ntools.io/api/v1/proxy/typebotwhich requires an additional API key for authorization.
Troubleshooting
- Error: Unknown chat operation — Ensure the operation name is exactly "generateUploadUrl" and the resource is set to "Chat".
- Authentication errors — Verify that the API key and token credentials are correctly configured and valid.
- File size limit exceeded — If uploads fail after URL generation, check that the file size does not exceed the specified
fileSizeLimitMb. - Invalid filename or missing fields — Confirm that the filename (if provided) is a valid string and does not contain unsupported characters.
- Network or proxy errors — Since the request goes through an external proxy, network issues or invalid proxy API keys can cause failures.
Links and References
- Typebot API Documentation (for detailed API endpoints and payloads)
- n8n Documentation (for creating and configuring custom nodes)
- Signed URL Uploads Concept (general concept explanation)