---
title: "Create translation requests"
method: POST
path: "/translation-requests"
tags: ["TranslationRequests"]
---

# Create translation requests

`POST /translation-requests`

## Request

- Base URL: `https://enterprise.knak.io/api/published/v1`
- URL: `https://enterprise.knak.io/api/published/v1/translation-requests`
- Auth: none declared
- TypeScript: <https://skmtc.dev/knak/apis/knak-enterprise-api/docs/translation-requests/post.ts> (a function with typed inputs; its response is checked against the schema)

Create one or more [translation requests](#tag/translation_request) for an asset using a custom translation integration. One translation request is created per code supplied in `language_codes`, and newly created requests start with a `status` of `requested`.

The `integration_id` must reference a `custom_translation` integration that belongs to your company. Every code in `language_codes` must be one of your company's supported translation languages — call `GET /translation-languages` first to retrieve the valid set.

**NOTE:** Only `custom_translation` integrations are supported by this endpoint. Integrations for marketing platforms or other translation providers (Smartling, TransPerfect, Lazarus) are rejected with `422 Unprocessable Entity`. Steps to set up a custom translation integration can be found [here](https://help.knak.io/en/articles/9687639-knak-custom-translation-integration-setup-guide).

## Request body

- object
  - `integration_id` string, required: ID of the `custom_translation` integration to use. Must belong to your company.
  - `asset_id` string, required: ID of the asset (email or landing page) to translate.
  - `language_codes` string[], required: One or more target language codes. Each must be a supported translation language for your company (see `GET /translation-languages`). Values must be unique; one translation request is created per code.
  - `notes` string, nullable: Optional notes or context stored on each created request. If omitted, the value will be null.
  - `due_date` string, nullable: Optional due date for the translation, in ISO 8601 format. If omitted, the value will be null.

## Response `201`

Created. Returns the translation requests that were created, one per language code.

- TranslationRequestCreatedList
  - `data` TranslationRequest[]: The translation requests that were created, one per requested language code.
    - `type` string
    - `id` string
    - `attributes` TranslationRequestAttributes
      - `id` string
      - `language_code` string: The language code of the translation target
      - `source_language_code` string, nullable: The language code of the translation source. If not set, the value will be null
      - `status` 'cancelled' | 'completed' | 'deleted' | 'failed' | 'manually_translating' | 'processing' | 'reopened' | 'requested' | 're_requested'
      - `base_asset_id` string: The ID of the Asset that should be translated
      - `asset_version_id` string: The ID of the Asset Version that should be translated
      - `integration_id` string: The ID of the integration that was used to request the translation
      - `user` User
        - `id` string
        - `name` string
        - `email` string
        - `roles` string[]: The roles for the user. Can be any of the roles defined for the company including custom roles.
      - `notes` string, nullable: Any notes or context relating to the translation request. If not set, the value will be null
      - `due_date` string, nullable: The date the translation is due. If not set, the value will be null
      - `created_at` string
      - `updated_at` string

## Other responses

- `400`: Validation error
- `401`: Unauthenticated
- `403`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity. Returned when `integration_id` is not a `custom_translation` integration belonging to your company, or when one or more `language_codes` are not supported for your company.

---

[API](https://skmtc.dev/knak/apis/knak-enterprise-api.md) - [All operations](https://skmtc.dev/knak/apis/knak-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/knak/apis/knak-enterprise-api/revisions/31d2c94edfcc?raw)