Skip to main content
Latch Registry allows you to perform a one-way sync to bring entities from Benchling Registry and Benchling Inventory to Latch Registry as tables. Once Benchling data is transformed into table forms on Latch, you can:
  • Easily search, sort, filter, and join data across tables.
  • Directly sync sequences from Benchling Protein entities, for example, and kick-start hundreds of AlphaFold2 for protein prediction or DNA Chisel for codon optimization.
This document walks through the process of setting up the Benchling one-way data sync to the Latch Registry.
The list of currently supported Benchling schemas are Custom Entities, DNA Sequences, AA Sequences, Mixtures, DNA Oligos, RNA Oligos, Molecules, and Plates.

​
Setup Benchling Sync

The integration works by using your Benchling developer API key.
1

Set up Benchling.

In Latch Console, go to Workspace Settings > Developer, and click on Benchling.
2

Get your personal API key.

Follow the official Benchling tutorial to get your personal user API key.
3

For `BENCHLING_API_KEY`, enter your Benchling API key.

Ex. sk_example_key.
4

For `BENCHLING_TENANT_URL` enter your tenant URL.

Include the full tenant URL including https://.
To find the tenant URL, log into your Benchling account or organization and copy the URL in the address bar as indicated in the image below.Ex. https://latch.benchling.com/.
5

Click `Submit` to save your Benchling credentials which will securely store your credentials in Amazon Secrets Manager.

6

You will see your Benchling secrets added to the `Workspace Secrets` section.

​
Syncing Data Using Benchling Sync

After successfully adding your Benchling credentials to Latch, you can go to the Latch Registry and sync your Benchling data to a new project on Latch.
Only one-way sync from Benchling to Latch is supported at the moment.
1

Go to `Registry`.

2

Create a new project by clicking `New Project` in the sidebar.

3

Click on `Benchling Data Sync` in the top right corner.

4

Select the project to sync data into.

5

Use the selector to switch between Plate and Entity schemas.

6

Check the Benchling Schemas and columns that you want to sync.

These schemas will be synced into the tables under the project that you have selected in step 4. If the entity schema you selected links to other schemas, the related schemas will be automatically selected for an sync as well. This is to ensure the parent-child relationships in Benchling are also propagated to Latch Registry tables.

​
(Optional) Enable Automatic Sync

If this option is enabled, your data will be automatically synced from Benchling to Latch every 30 minutes.
1

Click `Save Sync Settings` to save the state of your sync.

2

Click `Manual Sync` to manually sync all the schemas that you have selected into Latch.

Depending on the size and the amount of schemas that you are syncing, this might take a couple of minutes. Please keep the tab with the sync open. If you need to use the rest of the platform, please open a new tab and go to the Console page there.
3

After the sync exits, all of the schemas that you have selected will be available in the specified project.