Product Export via Mapping Profile

Updated 9 months ago ​by nussi


In order to do product export via mapping profile, you must:

  • Be authenticated user

For information on how you can authenticate, see: Authentication

As soon as you do authentication and receive a valid token, it needs to be passed on the call to the server.

Mapping Profiles

Getting available mapping profiles can be done from here:

Current example is for TT server. For your server it will be:


Mapping profile will be used for doing products export.

Endpoint for exporting via Mapping Profile

Example for such endpoint for TT server is

For your server:



  • Method Type: HttpPost
  • Authorization: Use Bearer Token + token received from token authentication
  • Header info: Content-Type: application/json

Request Model

Field Name





Mapping profile key received from above endpoint.



File format type of exported data.

TAB_Delimited = 0
CSV = 1
Excel = 2


Array of strings

List of product SKUs.


  • If user is authenticated then response will be Status Code 200 => OK and a queued job link.
  • If user is not authenticated, then response will be Status Code 401 => Not Valid Token
  • On server response => Status Code 500 => Internal Server Error

Demo in c#

private static string token = "test token";

static async Task<string> GetFirstMappingProfile()
string url = $"";

using (HttpClient client = new HttpClient())
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
HttpResponseMessage responseMessage = await client.GetAsync(url);

var content = responseMessage.Content

var profiles = JsonConvert.DeserializeObject<GetProfilesResponse>(content);
return profiles.MappingProfiles

static async Task Export(string profile)
string url = $"";
var content = new ExportRequest()
ProductIds = new string[] { "test" },
PluginProfileKey = profile,
FileFormat = FileFormat.Excel

using (var client = new HttpClient())
using (var request = new HttpRequestMessage(HttpMethod.Post, url))
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);

var json = JsonConvert.SerializeObject(content);
using (var stringContent = new StringContent(json, Encoding.UTF8, "application/json"))
request.Content = stringContent;

HttpResponseMessage responseMessage = await client.SendAsync(request);
var jobLink = await responseMessage.Content.ReadAsStringAsync();

static async Task Main(string[] args)
var profile = await GetFirstMappingProfile();

var jobLink = await Export(profile);

How did we do?