If you need to export not only the main email template but also all its language versions, you can do this via API. This guide explains how to do it step-by-step.
Step 1. Validate Your Token:
Before making any API requests, you need to validate your token to ensure it's active and correct.
You can send requests using your own service or tool, but for this example, we’ll be using Postman.
Open Postman and click the “+” button to create a new request.
Set the method to GET and enter the following URL:
https://my.stripo.email/emailgeneration/v1/validate
Go to the Headers tab and add these two key-value pairs:
Key | Value |
Stripo-Api-Auth | YOUR_JWT_TOKEN |
Content-Type | application/json |
You can find YOUR_JWT_TOKEN under the "Project" settings - "REST API" tab:
Step 2. Enable the includeTranslationVersions Parameter:
Stripo API supports a new parameter called includeTranslationVersions
, which is set to false
by default.
If you don’t specify this parameter or set it to
false
, you will receive only the main version of the email without translations.If you set
includeTranslationVersions=true
, the API will export the main email along with all its language versions.
Step 3. Where to Specify the Parameter:
You need to add this parameter as a query parameter in the request URL.
For example, if you’re making a GET request to retrieve an email by its ID:
https://my.stripo.email/emailgeneration/v1/export/html/emails/{emailId}?includeTranslationVersions=true
Step 4. Making the Request via Postman:
Open Postman.
Create a new request with the GET method.
Insert the URL including the
includeTranslationVersions=true
parameter.Use the same headers as in Step 1, including:
Authorization: Bearer <your_token>
Content-Type: application/json
Click on the "Send and Download".
Step 5. Exporting and Saving the File with Language Versions:
To receive all language versions, use Postman’s Send and Download feature, which lets you save the API response as a file.
Save the file with a
.zip
extension, for example,email.zip
.
Open the zip archive on your PC. Inside, you’ll find the main email and its translated versions.
Thank you for taking the time to read our articles. We hope you will find this information helpful.
If you have any additional questions, please email us at support@stripo.email.
We would be glad to talk with you.