N8N Tools - Uazapi icon

N8N Tools - Uazapi

Complete Uazapi integration - Premium WhatsApp API with advanced messaging and automation

Actions37

Overview

The "Upload Media" operation of the Media resource in this node allows users to upload media files (such as images, videos, audio, documents, or stickers) to the Uazapi server. This is useful when you want to store media on the server before sending it via WhatsApp messages or for other processing purposes.

Typical use cases include:

  • Uploading a media file once and then referencing it multiple times in different messages.
  • Preparing media content in advance for campaigns or automated messaging workflows.
  • Managing media assets centrally within your WhatsApp automation setup.

For example, you might upload an image file to the server and then send it later as part of a message without needing to re-upload it each time.

Properties

Name Meaning
Additional Fields Optional extra parameters:
- Reply to Message ID: ID of the message to reply to
- Delay (seconds): Delay before sending the message
- Disable Link Preview: Whether to disable link previews in messages (true/false)
- Mention Users: Comma-separated phone numbers to mention in the message

Note: For the Upload Media operation specifically, the main required input property is:

Name Meaning
Media URL URL or base64 string of the media file to upload

Output

The node outputs JSON data containing the response from the Uazapi API after uploading the media. This typically includes metadata about the uploaded media such as its unique media ID, URLs, status, or any relevant information returned by the server.

No binary data output is produced by this operation; it only returns JSON metadata about the uploaded media.

Dependencies

  • Requires an active Uazapi API credential with an API key, API token, instance ID, and API URL configured in n8n.
  • The node sends requests to the Uazapi service endpoint via a proxy at https://n8ntools.io/api/v1/proxy/uazapi.
  • Proper network connectivity to the Uazapi service and the proxy endpoint is necessary.

Troubleshooting

  • Invalid Media URL: Ensure the media URL or base64 string provided is valid and accessible. Invalid URLs or corrupted base64 data will cause upload failures.
  • Authentication Errors: If the API key or token is incorrect or expired, the request will fail. Verify credentials are correctly set up.
  • Instance ID Issues: The instance ID must be valid and active. Using an incorrect instance ID will result in errors.
  • API Rate Limits: Excessive requests may trigger rate limiting. Implement delays or retries if needed.
  • Network Connectivity: Check that your n8n instance can reach both the Uazapi API and the proxy endpoint.

Common error messages usually relate to authentication failure, invalid parameters, or network issues. Review the error message details returned in the JSON output for guidance.

Links and References

Discussion