X

Interact with X (Twitter) API

Actions10

Media → Upload Media

AI-generated

Overview

This node enables interaction with a social media platform's API, specifically focusing on uploading media files such as images and videos. The "Upload Media" operation under the "Media" resource allows users to upload binary media content (images or videos) directly to the platform. This is useful in scenarios where you want to programmatically add media content to posts or tweets.

Practical examples include:

  • Automatically uploading images or videos from an external source to your social media account.
  • Integrating media uploads into automated workflows for marketing campaigns.
  • Archiving or reposting media content by first uploading it via this node.

Properties

Name Meaning
Authentication Method of authentication to use: either OAuth1.0a or Bearer Token.
Binary Property The name of the binary property in the input data that contains the media file to upload.
Media Type The MIME type of the media being uploaded. Options: Image (GIF), Image (JPG), Image (PNG), Video (MP4).

Output

The node outputs JSON data representing the response from the media upload API endpoint. This typically includes information about the uploaded media such as media ID and status. The output does not contain binary data but metadata about the uploaded media.

Dependencies

  • Requires valid API credentials for authentication, either via OAuth1.0a or a Bearer Token.
  • The node uses helper functions to convert binary data to base64 encoding before uploading.
  • No additional external dependencies beyond the configured API credentials and network access to the social media platform's API.

Troubleshooting

  • Common issues:

    • Incorrect binary property name: Ensure the binary property specified matches the actual binary data key in the input.
    • Unsupported media type: Verify the media MIME type is one of the supported options (GIF, JPG, PNG, MP4).
    • Authentication errors: Confirm that the provided API credentials are valid and have permissions to upload media.
    • Large file sizes may cause upload failures depending on API limits.

  • Error messages:

    • Errors returned from the API will be included in the output if "Continue On Fail" is enabled.
    • Common error messages might relate to invalid media format, authentication failure, or rate limiting.
    • To resolve, check credentials, verify media format and size, and consult API documentation for limits.

Links and References

Discussion