---
title: "Add Project Strings Exporter Settings"
method: POST
path: "/projects/{projectId}/strings-exporter-settings"
tags: ["Projects"]
---

# Add Project Strings Exporter Settings

`POST /projects/{projectId}/strings-exporter-settings`

## Request

- Base URL: `https://api.crowdin.com/api/v2`
- URL: `https://api.crowdin.com/api/v2/projects/{projectId}/strings-exporter-settings`
- Auth: none declared
- TypeScript: <https://skmtc.dev/crowdin/apis/crowdin-api-v2/docs/projects/:projectId/strings-exporter-settings/post.ts> (a function with typed inputs; its response is checked against the schema)

**Required scopes:** `project.settings` (Read and Write).

## Path parameters

- `projectId` integer, required

## Request body

- union
  - AndroidSystemStringsExporterSettings
    - `format` string, required: Defines strings exporter format
    - `settings` AndroidSystemStringsExporterSettingsSettings, required
      - `convertPlaceholders` boolean: Convert placeholders to Android format.
      - `convertLineBreaks` boolean: Сonvert simple line breaks (Enter) to \n (e.g. New\nLine).
      - `useCdataForStringsWithTags` boolean: Encloses strings with HTML tags in CDATA sections (e.g., `<b>Name</b>` > `<![CDATA[<b>Name</b>]]>`). Does not apply to strings with only `<xliff:g>` tags.
  - MacOSXSystemStringsExporterSettings
    - `format` string, required: Defines strings exporter format
    - `settings` MacOSXSystemStringsExporterSettingsSettings, required
      - `convertPlaceholders` boolean: Convert placeholders to MacOSX format.
      - `convertLineBreaks` boolean: Сonvert simple line breaks (Enter) to \n (e.g. New\nLine).
      - `exportContext` boolean: Export string context as a comment above each string (e.g. `/* Context */`).
  - XliffSystemStringsExporterSettings
    - `format` string, required: Defines strings exporter format
    - `settings` XliffSystemStringsExporterSettingsSettings, required
      - `languagePairMapping` LanguagePairMapping: Defines language pair mapping
      - `copySourceToEmptyTarget` boolean: Copy source to empty target.
      - `exportTranslatorsComment` boolean: Export comments added by translators.

## Response `201`

Strings exporter settings was successfully created

- SystemStringsExporterSettingsResource: Base schema of resource container. Container is a wrapper object that contains payload in required `data` property and provides space for adding any other metadata.
  - `data` SystemStringsExporterSettings, required
    - `id` integer
    - `format` string
    - `settings` union: Defines file format settings
      - object
        - `convertPlaceholders` boolean: Convert placeholders to Android format.
        - `convertLineBreaks` boolean: Сonvert simple line breaks (Enter) to \n (e.g. New\nLine).
        - `useCdataForStringsWithTags` boolean: Encloses strings with HTML tags in CDATA sections (e.g., `<b>Name</b>` > `<![CDATA[<b>Name</b>]]>`). Does not apply to strings with only `<xliff:g>` tags.
      - object
        - `convertPlaceholders` boolean: Convert placeholders to MacOSX format.
        - `convertLineBreaks` boolean: Сonvert simple line breaks (Enter) to \n (e.g. New\nLine).
        - `exportContext` boolean: Export string context as a comment above each string (e.g. `/* Context */`).
      - object
        - `languagePairMapping` LanguagePairMapping: Defines language pair mapping
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `400`: Invalid Request Parameters
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Project Not Found
- `405`: Method Not Allowed
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crowdin/apis/crowdin-api-v2.md) - [All operations](https://skmtc.dev/crowdin/apis/crowdin-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/crowdin/apis/crowdin-api-v2/revisions/27aae7751699?raw)
