First Time Set Up

This guide walks you through setting up your Fastino Personalization API workspace, generating API keys, and running your first end-to-end test using sandbox mode.

Step 1: Create a Developer Account

Visit the Fastino Developer Portal: https://fastino.ai
Click Sign Up and complete your registration.
Verify your email address by clicking the link sent to your inbox.
Once verified, you’ll be redirected to the Developer Dashboard.

Your dashboard includes:

API key management
Usage metrics
Logs and error monitoring
Team access control

Step 2: Generate an API Key

Each workspace begins with a test key.
You can later generate live keys for production integrations.

Example Keys

⚠️ Keep your keys secret.
Never commit them to source control or expose them in frontend code.

Step 3: Set Up Your Environment

Option 1 – Using curl
Make sure curl is installed (preinstalled on most systems).

Option 2 – Using Python
Install the requests library:

Option 3 – Using Node.js
Install axios:

Step 4: Authenticate a Request

Every request must include your bearer token in the header.

Example Request

curl -X GET "https://api.fastino.ai/summary?user_id=usr_demo" \
  -H "Authorization: x-api-key: sk_test_12345example" \
  -H "Content-Type: application/json"

Example Response

{
  "user_id": "usr_demo",
  "generated_at": "2025-10-27T12:00:00Z",
  "purpose": "overview",
  "summary": "Demo user profile loaded successfully."
}

If you see a 401 Unauthorized error, check that your key is active and matches the correct environment.

Step 5: Register Your First User

Now let’s create your first user profile.

curl -X PUT "https://api.fastino.ai/register" \
  -H "Authorization: x-api-key: sk_test_12345example" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "usr_demo",
    "traits": {
      "name": "Demo User",
      "timezone": "America/Los_Angeles",
      "notes": "Testing workspace setup"
    }
  }'

Response

{
  "user_id": "usr_demo",
  "status": "active",
  "created_at": "2025-10-27T12:05:00Z"
}

The user is now stored in your workspace.

Step 6: Ingest a Test Event

Send a mock event (like an email or message) to validate ingestion.

curl -X POST "https://api.fastino.ai/ingest" \
  -H "Authorization: x-api-key: sk_test_12345example" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "usr_demo",
    "source": "test",
    "events": [
      {
        "event_id": "evt_demo_1",
        "type": "note",
        "timestamp": "2025-10-27T12:10:00Z",
        "content": "This is a sample event confirming setup."
      }
    ]
  }'

Response

{
  "ingested": { "events": 1, "documents": 0 },
  "updated_at": "2025-10-27T12:10:02Z"
}

Step 7: Query the Profile

Confirm that the personalization system is active by asking a question.

curl -X POST "https://api.fastino.ai/query" \
  -H "Authorization: x-api-key: sk_test_12345example" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "usr_demo",
    "question": "What was the last event stored for this user?"
  }'

Response

{
  "user_id": "usr_demo",
  "answer": "The last recorded event was a note titled 'sample event confirming setup'."
}

You’re now ready to start building your own adaptive, context-aware applications on top of Fastino.

Next, continue to the API Reference for detailed endpoint documentation.

Persona Adaptation

Routine Prediction

Join our Discord Community

On this page

Title