Skip to main content

How to export emails with translation versions via Stripo API?

In this article you will find out how to export emails via Stripo API with language version.

Elmira avatar
Written by Elmira
Updated over a week ago

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.


Did this answer your question?