# Get Started with SkhokhoAI

### 1) Create your SkhokhoAI account (Org Owner)

1. Go to [**https://skhokho.ai**](https://skhokho.ai) and click **Create account**.
2. Complete sign-up. The first user automatically becomes the **Organization Owner**.

### 2) Invite your team

As the **Organization Owner**, you can invite teammates to collaborate under your org:

1. Open **Organization settings → User Managemt**.
2. Click **Invite member**, add email(s), assign the appropriate role(s).
3. Send invites. Users will receive an email to join your organization.

> For more information on setup, see the public help center: [**https://skhokho.ai/public-help/**](https://skhokho.ai/public-help/)

### 3) Understand authentication (Basic Auth)

The SkhokhoAI API uses **HTTP Basic Authentication** (username + password) over TLS.

* **Username**: your SkhokhoAI account email
* **Password**: your SkhokhoAI account password
* The client sends `Authorization: Basic <base64(username:password)>`.
* **Do not** hardcode credentials. Store them securely (password manager / secrets manager) and load them via environment variables.

***

### 4) Make your first call

Once your credentials are ready, you can test the API using any HTTP client.

You can now start using the API to make calls (e.g: User Profile, Organization Management, etc..) for testing.

### Example:

<figure><img src="https://2122050779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLAQV5NHJaB8k0iy2WcIR%2Fuploads%2FZVabiyIfgboecw87789W%2FScreenshot%202025-10-15%20at%2015.58.39.png?alt=media&#x26;token=f4e4e4af-6e0d-424e-a5f5-7dc1a7a5d64a" alt=""><figcaption></figcaption></figure>

#### Step 1: Open any read-only endpoint

**User Profile → `GET /api/v1.0/me/`**

This endpoint returns the profile of the currently authenticated user.

#### Step 2: Click **Test it**

On the right-hand panel, click the blue **Test it** button.

#### Step 3: Enter your credentials

1. In the **Authorizations** dropdown, select **basicAuth**
2. Enter your **SkhokhoAI username (email)** and **password**

> The API uses HTTP Basic Auth. GitBook automatically encodes and sends the credentials for you.

#### Step 4: Click **Send**

GitBook will perform the request and display:

* Status code (e.g. `200 Success`)
* Response body (JSON)
* Headers

#### Step 6: Validate the response

A `200 OK` response confirms your:

* Account is active
* Basic Auth is working
* Organization access is valid

You are now ready to start using the API for automation and integration.

### Important: Never hardcode your credentials

Configure environment variables (recommended). Set credentials once; reference them everywhere.

```
SKHOKHOAI_USERNAME="you@example.com"
SKHOKHOAI_PASSWORD="your-strong-password"
SKHOKHOAI_BASE_URL="https://skhokho.ai" 

```