Skip to main content

How to integrate WeTransform into your website

Two integration modes, one result: your clients upload and transform files without ever leaving your platform.

Written by StΓ©phane Jauffret
Updated over 2 weeks ago

WeTransform can be embedded directly into your website or application β€” so your clients never need to know WeTransform exists. They upload their files, see the transformation, fix errors, and submit β€” all within your interface.

There are two integration modes. Choose the one that fits your technical setup.

πŸ–₯️ Mode 1 β€” Embed via iframe (inline)

The iframe mode displays the full WeTransform interface inside your page. Your client never leaves your site β€” the upload, match, finalize, and submit steps all happen inline.

[πŸ“Έ ILLUSTRATION: Side-by-side showing a branded website with WeTransform embedded as an iframe panel inside the page]

To embed, point an iframe to your branded WeTransform URL with the appropriate parameters:

<iframe
  src="https://your-name.send-a-file.io/template-handle?customer_id=1234&signature=..."
  width="100%"
  height="800px"
  frameborder="0"
></iframe>

Every request must include a HMAC SHA256 signature to authenticate the session. See Authentication β€” how to make the experience seamless for your clients.

πŸ”— Mode 2 β€” Redirect to a branded page

Instead of embedding an iframe, you redirect your client to a dedicated WeTransform page at your custom URL: your-company.send-a-file.io. This page displays your logo and colors β€” it looks like your product.

[πŸ“Έ ILLUSTRATION: Branded send-a-file.io page showing a company logo, colors, and the WeTransform upload interface]

Once the client submits their file, WeTransform redirects them back to your Return URL with a signed download link β€” your system receives the transformed file automatically.

βš™οΈ The WeTransform SDK

For deeper integration, WeTransform provides an SDK that handles the HMAC signature generation, redirection logic, and return URL verification. This abstracts the security layer so your development team doesn't have to implement it from scratch.

For full SDK documentation and code examples in PHP, Python, JavaScript, and more:

πŸ”„ The end-to-end flow

  1. Your client clicks "Upload file" on your platform

  2. Your server generates a signed URL and redirects (or embeds via iframe)

  3. The client uploads their file, reviews errors, and submits

  4. WeTransform redirects to your Return URL with the transformed file URL

  5. Your system downloads the file and integrates it β€” done

πŸ” Webhooks as an alternative. Instead of using the Return URL redirect, you can configure a webhook to receive the file automatically as soon as it's processed β€” without waiting for the client to complete the flow. See How to receive your output automatically with webhooks.

πŸ‘‰ What to do next

Did this answer your question?