Skip to main content
Version: Current

Upload WhatsApp Media

Description​

Uploads media content to the WhatsApp Business Platform using base64-encoded file data.

The activity uploads the media to WhatsApp and returns a Media ID that can be used by other activities such as Send WhatsApp Message for media-based messaging operations.

Common Capabilities​

Process Data Support​

info

This activity supports dynamic configuration using values from the Process Data drawer.

You can bind values from Model Data, Form Data, System Data, Enterprise Variables, and activity outputs.

Learn more → Using Process Data

Design-Time Configuration​

Connection Name​

Specifies the WhatsApp connection used for authentication and API communication.

Media Data (Base64)​

Specifies the base64-encoded representation of the media file to upload.

This field must contain the complete encoded content of the file.

MIME Type​

Specifies the MIME type representing the uploaded media format.

Examples include:

  • image/jpeg
  • image/png
  • video/mp4
  • audio/mpeg
  • application/pdf

File Name​

Specifies the optional filename associated with the uploaded media.

If not provided, a filename may be automatically generated based on the MIME type.

Caption​

Specifies optional caption text associated with the uploaded media.

This field is applicable only for supported media types such as:

  • Images
  • Videos
  • Documents

Wait All Incoming​

Execution Control

Controls how the activity behaves when multiple incoming execution paths converge.

Determines whether the activity executes when:

  • any incoming execution path completes, or
  • all relevant execution paths complete before execution

Learn more → Execution Control

On Error​

Error Handling Strategy

Defines how the workflow behaves if this activity encounters a runtime error.

Supported strategies include:

  • Fault
  • Continue
  • Suspend
  • Retry

Learn more → Error Handling

Outputs​

Raw JSON Response​

Contains the complete JSON response returned by the WhatsApp API after the media upload operation.

Media ID​

Represents the unique identifier assigned to the uploaded media by WhatsApp.

This Media ID can be used in activities such as Send WhatsApp Message to send previously uploaded media content.

Notes​

note
  • Uploaded media availability and retention are controlled by WhatsApp Business Platform policies.
  • Supported media formats and maximum file sizes are subject to WhatsApp platform limitations.
  • The provided MIME type should accurately match the uploaded media content.