# API Quickstart

## ![](/files/phxH5Cex1fAN3mNPlyOI) Overview

This quickstart provides the essential information you need to start working with the Flosum Cloud Apps API. It is designed to help you get oriented quickly so you can begin issuing requests with confidence.

### Available APIs

Currently available Flosum Cloud Apps public APIs:

<table><thead><tr><th width="160">API</th><th>Description</th></tr></thead><tbody><tr><td><a href="/pages/Tj2TTlAW71w6HWYcrBch">Global Settings</a></td><td>Authenticate the connection to your Flosum Cloud Apps tenant.</td></tr><tr><td><a href="/pages/dEbT3FxqI9BELqVuUUMF">Backup &#x26; Archive</a></td><td>Create, schedule, run, and manage your backups and archives.</td></tr></tbody></table>

#### Base URL

The table below lists the base URL for each API. Because Flosum tenants are regionally hosted, use the base URL for the region where your tenant is hosted.

<table><thead><tr><th width="160.3333740234375">API</th><th>United States</th><th>Germany</th><th>Japan</th><th>Australia</th></tr></thead><tbody><tr><td>Global Settings</td><td>global-us.flosum.app</td><td>global-de.flosum.app</td><td>global-jp.flosum.app</td><td>global-au.flosum.app</td></tr><tr><td>Backup &#x26; Archive</td><td>backup-us.flosum.app</td><td>backup-de.flosum.app</td><td>backup-jp.flosum.app</td><td>backup-au.flosum.app</td></tr></tbody></table>

{% hint style="warning" %}

### Connections vs Organizations

In the Flosum Cloud Apps API, the Salesforce orgs connected to your tenant are called **Connections**, whereas the Flosum Cloud Apps UI refers to them as **Organizations**. Both terms describe the same resource, so an Organization shown in the UI corresponds directly to a Connection returned by the API. Keep this mapping in mind when cross-referencing UI actions with API requests or responses.
{% endhint %}

## Authentication

The Flosum Cloud Apps APIs support OAuth 2.0 authentication through the Global Settings API. Below are the basic steps required to authenticate the connection. This process assumes you are already familiar with OAuth 2.0 authentication using the `authorization_code` flow.

{% stepper %}
{% step %}

### Create Connected App

To authenticate with your Flosum Cloud Apps tenant, you must have a Connected App in Global Settings. This Connected App provides the Client ID and Client Secret values used in authentication. To learn how to create a Connected App to connect an API, see the following article.

* [Creating a Connected App for API Access](/global-settings/security/connected-apps/creating-a-connected-app-for-api-access.md)
  {% endstep %}

{% step %}

### Get Authorization Code

**Endpoint**: [Broken mention](broken://pages/ad43f77206542839f6b0cd877cfd7e4f8726a733#get-api-v1-oauth-authorize)

Open the authorization URL in a browser, sign in to Global Settings, and approve the connected app. After the browser redirects to your callback URL, copy the `code` query parameter from that URL.
{% endstep %}

{% step %}

### Exchange the Code for a Token

**Endpoint**: [Broken mention](broken://pages/ad43f77206542839f6b0cd877cfd7e4f8726a733#post-api-v1-oauth-token)

Send the request using the body keys below.

<table><thead><tr><th width="199.6666259765625">Key</th><th>Value</th></tr></thead><tbody><tr><td><code>grant_type</code></td><td><code>authorization_code</code></td></tr><tr><td><code>code</code></td><td>The <strong>Authorization Code</strong> from the previous step.</td></tr><tr><td><code>redirect_uri</code></td><td>The same redirect URI used in the previous step.</td></tr><tr><td><code>client_id</code></td><td>Your <code>Client Id</code></td></tr><tr><td><code>client_secret</code></td><td>Your <code>Client Secret</code></td></tr></tbody></table>

A successful `200` response returns an `access_token` and a `refresh_token`. Pass the `access_token` in the `Authorization: Bearer` header on subsequent API calls, and store the `refresh_token` so you can obtain a new access token when the current one expires.
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flosum.com/api/api-quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.