Authentication - Well Starter Kit

🔐 Authenticate with the Well API

To start using the Well API, you need to generate a Bearer token via the /auth/api_key endpoint using your client_id and client_secret — provided by the Well team.

Endpoint

POST https://api.wellapp.ai/auth/api_key

Request Body

{
  "client_id": "your-client-id",
  "client_secret": "your-client-secret"
}

client_id and client_secret are provided by the Well team when your account is provisioned.
Keep your credentials secure and never expose them in public code or frontend applications.

Example using cURL

curl -X POST https://api.wellapp.ai/auth/api_key \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "your-client-id",
    "client_secret": "your-client-secret"
  }'

Response

A successful response will return a JSON payload containing your bearer token:

{
  "token": "your-bearer-token",
  "expires_in": 3600
}

token: Use this token in the Authorization header for all subsequent API calls.
expires_in: Indicates how long the token is valid (in seconds).

Authenticated Requests

Use the bearer token like this:

curl https://api.wellapp.ai/documents \
  -H "Authorization: Bearer your-bearer-token"

🔒 Security Notes

Always use HTTPS when calling the API.
Never expose your client_secret or token in frontend code.
Tokens are short-lived; you can refresh them by repeating the authentication request.

✅ You’re Ready

Now that you’re authenticated, you can start using:

Need help? Reach out at support@wellapp.ai

​🔐 Authenticate with the Well API

​Endpoint

​Request Body

​Example using cURL

​Response

​Authenticated Requests

​🔒 Security Notes

​✅ You’re Ready