1

Signup or Login using the Turso CLI

Make sure to install the Turso CLI if you haven’t already.

2

Retrieve your account or organization slug

The Platform API can be used with your personal account or with an organization. You’ll need the obtain the slug of your account or organization using using the Turso CLI:

turso org list
3

Create a new Platform API Token

Now create a new API Token using the Turso CLI:

turso auth api-tokens mint quickstart

Make sure to save the token somewhere safe. We’ll need it next.

4

Fetch available Locations

Before we can create a group or database in a specific region, we’ll need to fetch the list of available regions:


The organizationSlug is the name of your organization or personal account.

5

Create a Group

All databases belong to a group that can exist in one or more locations.

Begin by creating a group, giving it a name and primary location:

6

Create a Database

Now create your first database in the group you created above:

7

Replicate Database to another region

Add another location to your group to replicate your database to another region:

8

Connect to your database

You now have a database, distributed across multiple regions that you can connect to using one of the official or experimental SDKs: