> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Smartling

> How to set up the Smartling connector, plus the actions and events that are available.

![Smartling](https://stackone-logos.com/api/smartling/filled/svg)

v1.1.2[See changelog](https://docs.stackone.com/connectors/smartling/changelog.md)

[70 actions](#actions) · [23 events](#events) · 1 auth method

Localization

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [API Token · Connector Profile](https://docs.stackone.com/connectors/smartling/guides/connector-profile/api-token.md)
>
> Uses an API Token (User Identifier and User Secret) created in Smartling. The token operates within the role and permiss...

Optionally, configure receiving Events for Smartling into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/smartling/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [API Token · Link Account](https://docs.stackone.com/connectors/smartling/guides/link-account/api-token.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

70 actions

ActionDescription

List Projects`smartling_list_projects`

Returns the list of projects for the account, with optional name filtering and pagination.

Get Project`smartling_get_project`

Returns the details of a single project.

Copy Project`smartling_copy_project`

Makes a copy of an existing project, creating a new one with a new name.

Get Project Copy Status`smartling_get_project_copy_status`

Checks whether a project copy request is complete and retrieves the new projectId.

Add Project Locale`smartling_add_project_locale`

Adds a new target locale to the project.

List Locales`smartling_list_locales`

List the available locales within Smartling, optionally filtered to a specified set of locale ids.

List Files`smartling_list_files`

List recently uploaded source files in a Smartling project, returning up to 100 files.

List File Types`smartling_list_file_types`

List all file types currently represented in a Smartling project.

Upload Source File`smartling_upload_source_file`

Upload original source content to Smartling for translation.

Download Source File`smartling_download_source_file`

Download the original version of a source file from Smartling.

Delete Source File`smartling_delete_source_file`

Remove a source file from Smartling so it is no longer available for download.

Rename Source File`smartling_rename_source_file`

Rename an uploaded source file by changing its fileUri.

Get File Status (Single Locale)`smartling_get_file_status`

Return detailed translation status information for a file in a single locale.

Get File Status (All Locales)`smartling_get_file_status_all_locales`

Return translation status information for a file across every locale.

Get File Last Modified (Single Locale)`smartling_get_file_last_modified`

Return the date a file was last modified in a specified locale.

Get File Last Modified (All Locales)`smartling_get_file_last_modified_all_locales`

Return the date a file was last modified in each locale.

Download Translated File`smartling_download_translated_file`

Download a translated file for one locale, multiple locales, or all locales.

Download Multiple Translated Files (ZIP)`smartling_download_translated_files_zip`

Download a ZIP archive of multiple translated files for the requested file URIs and locales (deprecated).

Download Multiple Translated Files (ZIP, POST)`smartling_download_translated_files_zip_post`

Download a ZIP archive of multiple translated files specifying files and locales in the request body.

Download All Translations (ZIP)`smartling_download_translated_files_all_locales_zip`

Download a ZIP archive with all translations for the requested file.

Export File Translations`smartling_export_file_translations`

Temporarily upload a file and return a translated version for the requested locale.

Import File Translations`smartling_import_file_translations`

Import translations for an existing file into a locale's workflow.

List Account Jobs`smartling_list_account_jobs`

List or search the translation jobs within an account.

List Jobs`smartling_list_jobs`

List or search the translation jobs within a project.

Create Job`smartling_create_job`

Create a new translation job within a Smartling project.

Get Job`smartling_get_job`

Get the details of a single translation job.

Update Job`smartling_update_job`

Update the attributes of an existing translation job.

Delete Job`smartling_delete_job`

Delete a cancelled translation job.

Search Jobs`smartling_search_jobs`

Search for jobs by hashcodes, file URIs, and translation job UIDs.

Find Jobs By Strings`smartling_find_jobs_by_strings`

Search for jobs by string hashcodes and locales.

Authorize Job`smartling_authorize_job`

Authorize all content within a translation job.

Cancel Job`smartling_cancel_job`

Cancel a translation job and unauthorize its content.

Close Job`smartling_close_job`

Close a completed translation job.

Get Job Progress`smartling_get_job_progress`

Get the translation progress of a job.

Get Job File Progress`smartling_get_job_file_progress`

Get the translation progress of a specific file within a job.

List Job Files`smartling_list_job_files`

List all files within a translation job.

Add File To Job`smartling_add_job_file`

Add all non-published strings from a file to a translation job.

Remove File From Job`smartling_remove_job_file`

Remove a file and its content from a translation job.

Add Strings To Job`smartling_add_job_strings`

Add strings identified by hashcodes to a translation job.

Remove Strings From Job`smartling_remove_job_strings`

Remove strings identified by hashcodes from a translation job.

List Job Strings`smartling_list_job_strings`

Get the string hashcodes with locales for a translation job.

Add Locale To Job`smartling_add_job_locale`

Add a target locale to a translation job.

Remove Locale From Job`smartling_remove_job_locale`

Remove a target locale and its content from a translation job.

Get Job Completion Dates`smartling_get_job_completion_dates`

Get the last completion date per locale of a translation job.

Get Job Process Status`smartling_get_job_process_status`

Check the status of an asynchronous process for a translation job.

Get Job Schedule`smartling_get_job_schedule`

Get all schedule items for a translation job.

Update Job Schedule`smartling_update_job_schedule`

Modify the schedule items for a translation job.

List Account Custom Fields`smartling_list_account_custom_fields`

Get all custom fields defined for the specified Smartling account.

Create Custom Field`smartling_create_custom_field`

Create a new custom field in the specified Smartling account.

Update Custom Field`smartling_update_custom_field`

Update an existing custom field in the specified Smartling account.

List Project Custom Fields`smartling_list_project_custom_fields`

Get the custom fields assigned to the specified Smartling project.

Assign Project Custom Fields`smartling_assign_project_custom_fields`

Assign existing account custom fields to the specified Smartling project.

Add Strings`smartling_add_strings`

Upload an array of new source strings to a Smartling project, optionally authorizing them into translation workflows.

Get Add Strings Status`smartling_get_add_strings_status`

Check the processing status of a previously submitted add-strings request.

List Source Strings`smartling_list_source_strings`

Return source strings from a Smartling project, filtered by file URI or specific hashcodes.

Search Source Strings`smartling_search_source_strings`

Return source strings from a Smartling project using a POST request body to filter by file URI or hashcodes.

List Translations`smartling_list_translations`

Return translated strings from a Smartling project for a target locale, filtered by file URI or hashcodes.

Search Translations`smartling_search_translations`

Return translated strings from a Smartling project for a target locale using a POST request body to filter by file URI o...

Create Batch`smartling_create_batch`

Create a new batch for a translation job with a list of file names to be uploaded.

List Batches`smartling_list_batches`

List existing batches for the project, filtered by the given criteria.

Get Batch`smartling_get_batch`

Get batch status with detailed statuses of all batch items and their locales.

Execute Batch Action`smartling_execute_batch`

Process a batch action to register or cancel a file within an existing batch.

Upload Batch File`smartling_upload_batch_file`

Upload a file to an existing batch using multipart form-data.

Create Translation Job`smartling_create_batch_job`

Create a new translation job or fetch an existing one based on the specified criteria.

List Account Tags`smartling_list_account_tags`

List or search tags within an account, optionally scoped to specific projects.

List Project Tags`smartling_list_project_tags`

List or search tags within a project.

Add String Tags`smartling_add_string_tags`

Add a list of tags to a list of strings in a project.

Remove String Tags`smartling_remove_string_tags`

Remove a list of tags from a list of strings in a project.

Remove All String Tags`smartling_remove_all_string_tags`

Remove all tags from a list of strings in a project.

Search String Tags`smartling_search_string_tags`

Retrieve all tags linked to a list of strings in a project.

## Events

Tags

Select all
|
Clear

Files

Issues

Jobs

Webhooks

No tags found

23 events

EventDescriptionTags

File Uploaded Webhook`smartling_webhook_file_uploaded`

Processes Smartling file.uploaded webhook events.

FilesWebhooks

File Published Webhook`smartling_webhook_file_published`

Processes Smartling file.published webhook events.

FilesWebhooks

File Prepublished Webhook`smartling_webhook_file_prepublished`

Processes Smartling file.prepublished webhook events.

FilesWebhooks

File Renamed Webhook`smartling_webhook_file_renamed`

Processes Smartling file.renamed webhook events.

FilesWebhooks

File Deleted Webhook`smartling_webhook_file_deleted`

Processes Smartling file.deleted webhook events.

FilesWebhooks

Integration Asset Exported Webhook`smartling_webhook_integration_asset_exported`

Processes Smartling integrations.platform.asset.exported webhook events.

Webhooks

Source Issue Created Webhook`smartling_webhook_source_issue_created`

Processes Smartling sourceIssue.created webhook events.

IssuesWebhooks

Source Issue Updated Webhook`smartling_webhook_source_issue_updated`

Processes Smartling sourceIssue.updated webhook events.

IssuesWebhooks

Source Issue Deleted Webhook`smartling_webhook_source_issue_deleted`

Processes Smartling sourceIssue.deleted webhook events.

IssuesWebhooks

Source Issue Comment Created Webhook`smartling_webhook_source_issue_comment_created`

Processes Smartling sourceIssue.comment.created webhook events.

IssuesWebhooks

Source Issue Comment Updated Webhook`smartling_webhook_source_issue_comment_updated`

Processes Smartling sourceIssue.comment.updated webhook events.

IssuesWebhooks

Source Issue Comment Deleted Webhook`smartling_webhook_source_issue_comment_deleted`

Processes Smartling sourceIssue.comment.deleted webhook events.

IssuesWebhooks

Translation Issue Created Webhook`smartling_webhook_translation_issue_created`

Processes Smartling translationIssue.created webhook events.

IssuesWebhooks

Translation Issue Updated Webhook`smartling_webhook_translation_issue_updated`

Processes Smartling translationIssue.updated webhook events.

IssuesWebhooks

Translation Issue Deleted Webhook`smartling_webhook_translation_issue_deleted`

Processes Smartling translationIssue.deleted webhook events.

IssuesWebhooks

Translation Issue Comment Created Webhook`smartling_webhook_translation_issue_comment_created`

Processes Smartling translationIssue.comment.created webhook events.

IssuesWebhooks

Translation Issue Comment Updated Webhook`smartling_webhook_translation_issue_comment_updated`

Processes Smartling translationIssue.comment.updated webhook events.

IssuesWebhooks

Translation Issue Comment Deleted Webhook`smartling_webhook_translation_issue_comment_deleted`

Processes Smartling translationIssue.comment.deleted webhook events.

IssuesWebhooks

Translation Job Created Webhook`smartling_webhook_translation_job_created`

Processes Smartling translationJob.created webhook events.

JobsWebhooks

Translation Job Updated Webhook`smartling_webhook_translation_job_updated`

Processes Smartling translationJob.updated webhook events.

JobsWebhooks

Translation Job Completed Webhook`smartling_webhook_translation_job_completed`

Processes Smartling translationJob.completed webhook events.

JobsWebhooks

Translation Job Canceled Webhook`smartling_webhook_translation_job_canceled`

Processes Smartling translationJob.canceled webhook events.

JobsWebhooks

Translation Job Locale Workflow Step Reached Webhook`smartling_webhook_translation_job_locale_workflow_step_reached`

Processes Smartling translationJob.localeWorkflowStep.reached webhook events.

JobsWebhooks


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.