therappai Quick Start

A 5-minute guide to make your first request and see results.

This guide will help you make your first successful request to the therappai API. You’ll learn how to access the base URL, authenticate using a bearer token, and send your first API call.

Base URL

All requests to the therappai API are made to the following root:

Production

https://api.therappai.com/api/v1

Authentication

The therappai API uses JWT-based Bearer authentication.

To access most endpoints, you must first log in using the /login/ endpoint. A successful login returns:

  • access token — used in all API requests

  • refresh token — used to generate a new access token

You’ll include the access token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

Example of an authenticated header:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR...
Content-Type: application/json

Before you start

You will need:

  • A therappai user account (via /signup/ or in-app)

  • Your access token from /login/

  • A tool to test API calls (Postman, cURL, or your application code)

Step 1 — Create an account (Signup)

Send a POST request to:

POST /signup/

Body fields typically include:

  • email

  • name

  • password

  • confirm_password

If the user already exists, skip to login.

Step 2 — Log in & get your access token

POST /login/

On success, you’ll receive:

  • access — use this for API requests

  • refresh — store this securely on the client for refreshing sessions

Step 3 — Make your first authenticated request

Try fetching the user profile:

GET /profile/
Authorization: Bearer ACCESS_TOKEN_HERE

If the token is valid, you’ll get basic user info back (name, email, profile picture, etc.).

Step 4 — Refreshing tokens

When your access token expires, call:

POST /refresh/

Send the refresh token in the body. You’ll receive a new access token to continue making requests.

Testing your setup

If everything works, you should be able to:

  • Authenticate

  • Retrieve profile data

  • Begin using the core API features

From here, you can integrate:

  • Users

  • AI chat

  • Content

  • Moods

  • Daily tasks

  • Emergency contacts

Need help?

If you run into issues while getting started, contact:

developer@therappai.com

PreviousWelcome to the therappai Developer DocumentationNextAuthentication

Last updated