---
title: "Create Solvent"
method: POST
path: "/api/v3/solvent"
tags: ["Solvent"]
---

# Create Solvent

`POST /api/v3/solvent`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/solvent`
- Auth: HTTP bearer

Create a solvate in the tenant's Salt & Solvate library.

The Salt & Solvate library requires the salt and solvate forms feature to be enabled on your tenant; contact your Benchling representative to turn it on. Creating an entry requires tenant admin permissions. Structures are neutralized (uncharged) on creation and are immutable afterwards. The library is limited to 2000 non-archived entries, and each structure is limited to 50 atoms. Names, structures, and the optional `code` must each be unique (case-insensitive for names and codes) across all salts and solvates in the tenant. Archived entries still reserve their name and structure, so an archived match must be unarchived rather than recreated.

## Headers

- `EARLY-ACCESS` string

## Request body

- CreateSolventInput
  - `code` string, nullable: Optional configurable identifier for this solvate (e.g., "H2O"). Must be unique (case-insensitive) across the Salt & Solvate library.
  - `name` string, required: The name of the solvate. Must be unique (case-insensitive) across the Salt & Solvate library.
  - `smiles` string, required: The SMILES of the solvate. It is neutralized (uncharged) before storage, and the canonical SMILES and molecular formula are derived from it. Immutable after creation.

## Response `201`

Created

- Solvent: A Solvent is a compound in which solvent molecules are incorporated into the crystal lattice, used to represent the solvent form of a chemical compound in a tenant's solvent library. Solvents are referenced when creating molecules to describe the final form of a compound. Each solvent has a required SMILES from which the molecular formula is derived.
  - `__typename` string
  - `archiveReason` string, nullable
  - `archived` boolean
  - `calculatedMolecularWeight` number, double, nullable: The molecular weight of the solvent.
  - `canonicalSmiles` string: The SMILES representation of the solvent after standardization.
  - `code` string, nullable: Optional company-specific identifier for this solvent (e.g., "MH", "DH"). Unique across both salts and solvents within a tenant.
  - `createdAt` string, datetime
  - `id` string
  - `modifiedAt` string, datetime
  - `molecularFormula` string: The molecular formula (e.g., "H2O").
  - `molfile` string: The molfile representation of the solvent.
  - `name` string

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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