The API is available at: https://api.staging.wetransform.com OpenAPI Spec

API Overview

The WeTransform API allows you to programmatically manage file transformations, customer accounts, and integration workflows. Our API is built on RESTful principles and returns JSON-encoded responses.

Receiver API

The Receiver-side API is used for administrative tasks. Manage transformation templates, customer profiles, and organizational metadata. This is the control center for your transformation pipeline.

Sender API

The Sender-side API is designed for the actual transformation workflow. Monitor jobs, upload files for transformation, and manage results for specific customers using the /send/{subdomain} entry point.

Base URL: https://api.staging.wetransform.com


Authentication

WeTransform uses Bearer tokens to authenticate requests. You can generate and manage your API tokens in your account settings.

Example Header
Authorization: Bearer YOUR_TOKEN

Customer Impersonation (Sender API)

When interacting with the Sender API, you often need to perform actions on behalf of a specific customer. Use the X-Customer header to specify the target context.

Customer Context Header
X-Customer: customer@example.com // or use Internal ID

Localization & Internationalization

WeTransform supports multiple languages for system-generated content, including emails, error messages, and UI strings.

Supported Locales Path Prefix
fr /fr/...
en /en/...

The path prefix (e.g., /en/) determines the language of the response content but does not affect the functional behavior of the API.


Endpoints

Get Started

Methods Endpoint Permission(s)
Use these "Hello, world!" endpoints to check your authentication mechanisms, and test the different request verbs.
GET [Demo Receiver] Using parameters in the query string.
https://api.staging.wetransform.com/en/hello

All endpoints hit using GET verb take parameters in the query string. This test endpoint enables you to test that a simple call using parameters in the query string functions normally. It has no impact on the application.

GET [Demo Receiver] Using URL {attributes}.
https://api.staging.wetransform.com/en/hello/{name}

Sometimes, URLs can take attributes, that should be replaced by a resource identifier.

POST PUT DELETE [Demo Receiver] Using a JSON body.
https://api.staging.wetransform.com/en/hello

All endpoints hit using POST, PUT and DELETE take parameters in the request payload. This test endpoint enables you to test that a simple call using a JSON body functions normally. It has no impact on the application.

POST [Demo Receiver] Uploading files.
https://api.staging.wetransform.com/en/hello/file-upload

This test endpoint enables you to test that uploading a file to WeTransform functions normally. It has no impact on the application.

These endpoints are the same as above, but gives you access to your customer resources.
GET [Demo Sender] Using parameters in the query string.
https://api.staging.wetransform.com/en/send/{subdomain}/hello

All endpoints hit using GET verb take parameters in the query string.

GET [Demo Sender] Using URL {attributes}.
https://api.staging.wetransform.com/en/send/{subdomain}/hello/{name}

Sometimes, URLs can take attributes, that should be replaced by a resource identifier.

POST PUT DELETE [Demo Sender] Using a JSON body.
https://api.staging.wetransform.com/en/send/{subdomain}/hello

All endpoints hit using POST, PUT and DELETE take parameters in the request payload.

POST [Demo Sender] Uploading files.
https://api.staging.wetransform.com/en/send/{subdomain}/hello/file-upload

Sender

Methods Endpoint Permission(s)
Source feeds
GET [Source feeds] List source configurations.
https://api.staging.wetransform.com/sender/sources

Use this endpoint to list all source configurations.

POST [Source feeds] Create a source configuration.
https://api.staging.wetransform.com/sender/source
GET [Source feeds] Read a source configuration.
https://api.staging.wetransform.com/sender/source/{sourceId}
PUT [Source feeds] Update a source configuration.
https://api.staging.wetransform.com/sender/source/{sourceId}
DELETE [Source feeds] Delete a source configuration and its schedules.
https://api.staging.wetransform.com/sender/source/{sourceId}
DELETE [Source feeds] Deactivate schedules linked to a source.
https://api.staging.wetransform.com/sender/source/{sourceId}/schedules
POST [Source feeds] Activate schedules linked to a source.
https://api.staging.wetransform.com/sender/source/{sourceId}/schedules
Transformations
GET [Public Transformations] List transformations.
https://api.staging.wetransform.com/transformations

This endpoint will list all transformations, paginated. A transformation has a source file, a template name, and has been initiated, but has not necessarily finished.

GET [Public Transformations] List deleted transformations.
https://api.staging.wetransform.com/transformations/trash

This endpoint will list all deleted (trashed) transformations, paginated.

GET [Public Transformations] Read a transformation.
https://api.staging.wetransform.com/transformation/{transformationId}

This endpoint will give details about a particular transformation, such as its import date, source file name, download_url and more.

DELETE [Public Transformations] Delete a transformation.
https://api.staging.wetransform.com/transformation/{transformationId}

This endpoint will delete a transformation.

PUT [Public Transformations] Undelete a transformation.
https://api.staging.wetransform.com/transformation/{transformationId}

This endpoint will restore a previously deleted transformation.

DELETE [Public Transformations] Delete all transformations tied to a source.
https://api.staging.wetransform.com/transformation/delete-by-source/{sourceId}
PUT [Public Transformations] Undelete all transformations tied to a source.
https://api.staging.wetransform.com/transformation/undelete-by-source/{sourceId}
POST [Public Transformations] Run a transformation.
https://api.staging.wetransform.com/transformation/automation/{transformationId}

This endpoint can be used to run an existing transformation. It requires that

  1. a source file was already uploaded, 2) the source file is dynamic
  2. a template has been chosen. This will refresh the source file, and run the transformation with the new source file.
GET [Public Transformations] Get the status of a transformation.
https://api.staging.wetransform.com/transformation/automation/{automationId}

This endpoint will return the status of the transformation provided the source file is dynamic.

GET [Public Transformations] Get data from a transformation.
https://api.staging.wetransform.com/transformation/{transformationId}/data

This endoint allows to get portions of transformed file before it is actually submitted. A use case, if used with the update data from a transformation endpoint, is to allow to make changes to the file while a transformation is still pending and the file has not been submitted yet.

PUT [Public Transformations] Update data from a transformation.
https://api.staging.wetransform.com/transformation/{transformationId}/data

This endpoint allows to post changes to a transformation, such as updating content on specific attributes, before the file is actually fully transformed and submitted.

Submission
GET [Public Submission] List submissions.
https://api.staging.wetransform.com/sender/submissions
GET [Public Submission] List submissions for a transformation.
https://api.staging.wetransform.com/sender/submissions/transformation/{transformationId}
GET [Public Submission] Read a submission by its download URL.
https://api.staging.wetransform.com/sender/submission
GET [Public Submission] Read a submission.
https://api.staging.wetransform.com/sender/submission/{submissionId}

Receiver

Endpoints used to manage templates and customers

Methods Endpoint Permission(s)
Template management
GET [Public Template] List templates.
https://api.staging.wetransform.com/templates

Get a list of all templates and filter them using metadata in the query string. You can define metadata in the template's General setting menu. For example, this can be useful to categorize your templates.

GET [Public Template] Read a template.
https://api.staging.wetransform.com/template/{templateHandle}
GET [Public Template] List template's customers.
https://api.staging.wetransform.com/template/{templateHandle}/customers

Get a list of all customers having access to a particular template, using the template UUID.

Customers management
GET [Public Customer] List customers.
https://api.staging.wetransform.com/customers

Get the list of all your customers, including details such as WeTransform UUID, external_id, name, email, templates they have access to and more.

GET [Public Customer] Read a customer.
https://api.staging.wetransform.com/customer/{customerId}

Get details for a customer, such as its email, and list of available templates, from the WeTransform customer UUID.

PUT [Public Customer] Update a customer.
https://api.staging.wetransform.com/customer/{customerId}

Give specific templates access to a customer, using its WeTransform UUID, or update other details.

POST [Public Customer] Create a customer.
https://api.staging.wetransform.com/customer

Create a customer specifying its external_id, and allowing specific templates. Creating an already existing customer will return a 409 error.

DELETE [Public Customer] Delete a customer.
https://api.staging.wetransform.com/customer/{customerId}

Delete a customer using its WeTransform UUID. Deleting a customer will delete the corresponding transformations done by this customer.


Integrations

Methods Endpoint Permission(s)
Power functions
GET [Power functions] Fetch data from the transformation dataset.
https://api.staging.wetransform.com/power-functions/{callId}/{callNumber}/fetch
POST PUT [Power functions] Populate the function's result to the transformation dataset.
https://api.staging.wetransform.com/power-functions/{callId}/{callNumber}/populate
GET POST PUT PATCH DELETE [Power functions] Abort an ongoing Power function call.
https://api.staging.wetransform.com/power-functions/{callId}/{callNumber}/abort


Console


Please login in order to access the console.

© 2026