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.
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.
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 |
[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 |
[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 |
[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 |
[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
|
|
| 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 |
|
| 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
|
|