curl -X POST "https://api-integration.ollang.com/integration/orders/figma/create" \
-H "X-Api-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"fileKey": "UwNAtPYAu5JPIhFc03M71h",
"fileUrl": "https://www.figma.com/design/UwNAtPYAu5JPIhFc03M71h/My-Design",
"sourceLanguage": "en",
"targetLanguages": ["fr", "de", "tr"]
}'
const response = await fetch(
"https://api-integration.ollang.com/integration/orders/figma/create",
{
method: "POST",
headers: {
"X-Api-Key": "<your-api-key>",
"Content-Type": "application/json",
},
body: JSON.stringify({
fileKey: "UwNAtPYAu5JPIhFc03M71h",
fileUrl: "https://www.figma.com/design/UwNAtPYAu5JPIhFc03M71h/My-Design",
sourceLanguage: "en",
targetLanguages: ["fr", "de", "tr"],
}),
}
);
const result = await response.json();
console.log(result.orders); // [{orderId, targetLanguage, status}]
import requests
headers = {
'X-Api-Key': '<your-api-key>',
'Content-Type': 'application/json'
}
payload = {
'fileKey': 'UwNAtPYAu5JPIhFc03M71h',
'fileUrl': 'https://www.figma.com/design/UwNAtPYAu5JPIhFc03M71h/My-Design',
'sourceLanguage': 'en',
'targetLanguages': ['fr', 'de', 'tr']
}
response = requests.post(
'https://api-integration.ollang.com/integration/orders/figma/create',
headers=headers,
json=payload
)
result = response.json()
print(result['orders'])
{
"projectId": "60b8d6f1e1b9b1d8c6c0d8e1",
"importId": "60b8d6f1e1b9b1d8c6c0d8e2",
"orders": [
{
"orderId": "60b8d6f1e1b9b1d8c6c0d8e3",
"targetLanguage": "fr",
"status": "ongoing"
},
{
"orderId": "60b8d6f1e1b9b1d8c6c0d8e4",
"targetLanguage": "de",
"status": "ongoing"
},
{
"orderId": "60b8d6f1e1b9b1d8c6c0d8e5",
"targetLanguage": "tr",
"status": "ongoing"
}
]
}
{
"statusCode": 400,
"message": "Figma account not connected. Please connect your Figma account in the Ollang dashboard first."
}
{
"statusCode": 409,
"message": "An active order for \"fr\" already exists in this project. Wait for it to complete or cancel it before creating a new one."
}
Ollang API Reference
Create Figma Order
Import a Figma file and create translation orders in one step
POST
/
integration
/
orders
/
figma
/
create
curl -X POST "https://api-integration.ollang.com/integration/orders/figma/create" \
-H "X-Api-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"fileKey": "UwNAtPYAu5JPIhFc03M71h",
"fileUrl": "https://www.figma.com/design/UwNAtPYAu5JPIhFc03M71h/My-Design",
"sourceLanguage": "en",
"targetLanguages": ["fr", "de", "tr"]
}'
const response = await fetch(
"https://api-integration.ollang.com/integration/orders/figma/create",
{
method: "POST",
headers: {
"X-Api-Key": "<your-api-key>",
"Content-Type": "application/json",
},
body: JSON.stringify({
fileKey: "UwNAtPYAu5JPIhFc03M71h",
fileUrl: "https://www.figma.com/design/UwNAtPYAu5JPIhFc03M71h/My-Design",
sourceLanguage: "en",
targetLanguages: ["fr", "de", "tr"],
}),
}
);
const result = await response.json();
console.log(result.orders); // [{orderId, targetLanguage, status}]
import requests
headers = {
'X-Api-Key': '<your-api-key>',
'Content-Type': 'application/json'
}
payload = {
'fileKey': 'UwNAtPYAu5JPIhFc03M71h',
'fileUrl': 'https://www.figma.com/design/UwNAtPYAu5JPIhFc03M71h/My-Design',
'sourceLanguage': 'en',
'targetLanguages': ['fr', 'de', 'tr']
}
response = requests.post(
'https://api-integration.ollang.com/integration/orders/figma/create',
headers=headers,
json=payload
)
result = response.json()
print(result['orders'])
{
"projectId": "60b8d6f1e1b9b1d8c6c0d8e1",
"importId": "60b8d6f1e1b9b1d8c6c0d8e2",
"orders": [
{
"orderId": "60b8d6f1e1b9b1d8c6c0d8e3",
"targetLanguage": "fr",
"status": "ongoing"
},
{
"orderId": "60b8d6f1e1b9b1d8c6c0d8e4",
"targetLanguage": "de",
"status": "ongoing"
},
{
"orderId": "60b8d6f1e1b9b1d8c6c0d8e5",
"targetLanguage": "tr",
"status": "ongoing"
}
]
}
{
"statusCode": 400,
"message": "Figma account not connected. Please connect your Figma account in the Ollang dashboard first."
}
{
"statusCode": 409,
"message": "An active order for \"fr\" already exists in this project. Wait for it to complete or cancel it before creating a new one."
}
Import a Figma design file and create AI translation orders for one or more target languages. This endpoint handles the full pipeline: importing text layers from Figma, creating/reusing the project, and triggering translation for each target language.
The Figma file is always re-imported to capture the latest design state. If a project already exists for this file, it will be reused.
curl -X POST "https://api-integration.ollang.com/integration/orders/figma/create" \
-H "X-Api-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"fileKey": "UwNAtPYAu5JPIhFc03M71h",
"fileUrl": "https://www.figma.com/design/UwNAtPYAu5JPIhFc03M71h/My-Design",
"sourceLanguage": "en",
"targetLanguages": ["fr", "de", "tr"]
}'
const response = await fetch(
"https://api-integration.ollang.com/integration/orders/figma/create",
{
method: "POST",
headers: {
"X-Api-Key": "<your-api-key>",
"Content-Type": "application/json",
},
body: JSON.stringify({
fileKey: "UwNAtPYAu5JPIhFc03M71h",
fileUrl: "https://www.figma.com/design/UwNAtPYAu5JPIhFc03M71h/My-Design",
sourceLanguage: "en",
targetLanguages: ["fr", "de", "tr"],
}),
}
);
const result = await response.json();
console.log(result.orders); // [{orderId, targetLanguage, status}]
import requests
headers = {
'X-Api-Key': '<your-api-key>',
'Content-Type': 'application/json'
}
payload = {
'fileKey': 'UwNAtPYAu5JPIhFc03M71h',
'fileUrl': 'https://www.figma.com/design/UwNAtPYAu5JPIhFc03M71h/My-Design',
'sourceLanguage': 'en',
'targetLanguages': ['fr', 'de', 'tr']
}
response = requests.post(
'https://api-integration.ollang.com/integration/orders/figma/create',
headers=headers,
json=payload
)
result = response.json()
print(result['orders'])
Authorizations
This endpoint requires API key authentication. Include your API key in the request header:- Header name:
X-Api-Key - Header value: Your API key from the Ollang dashboard
Prerequisites
Your Figma account must be connected to Ollang via OAuth before using this endpoint.
Connect your Figma account from the Ollang dashboard under Settings → Integrations → Figma.
Body Parameters
string
required
The Figma file key. This is the identifier in the Figma URL between
/design/ and the file name.
Example: For https://www.figma.com/design/UwNAtPYAu5JPIhFc03M71h/My-Design, the file key is UwNAtPYAu5JPIhFc03M71h.string
required
The full Figma file URL. Must contain
figma.com.string
required
The source language code of the design content (e.g.,
en, fr, de).string[]
required
Array of target language codes to translate into. At least one is required.
string
Optional folder ID to organize the project in. If not provided, a default folder is used.
Response
string
The ID of the created or reused project.
string
The ID of the Figma import record containing extracted text layers.
array
Error Responses
| Status | Description |
|---|---|
| 400 | Figma account not connected, or missing/invalid parameters |
| 409 | An active order for a target language already exists in this project |
| 422 | Figma file import failed (API error or access issue) |
{
"projectId": "60b8d6f1e1b9b1d8c6c0d8e1",
"importId": "60b8d6f1e1b9b1d8c6c0d8e2",
"orders": [
{
"orderId": "60b8d6f1e1b9b1d8c6c0d8e3",
"targetLanguage": "fr",
"status": "ongoing"
},
{
"orderId": "60b8d6f1e1b9b1d8c6c0d8e4",
"targetLanguage": "de",
"status": "ongoing"
},
{
"orderId": "60b8d6f1e1b9b1d8c6c0d8e5",
"targetLanguage": "tr",
"status": "ongoing"
}
]
}
{
"statusCode": 400,
"message": "Figma account not connected. Please connect your Figma account in the Ollang dashboard first."
}
{
"statusCode": 409,
"message": "An active order for \"fr\" already exists in this project. Wait for it to complete or cancel it before creating a new one."
}
Was this page helpful?