Track your first product event / Getting started • Altertable Docs

Track your first product event

Send one event and verify it before instrumenting your application.

1. Enable Product Analytics

In Catalogs, choose New Catalog and enable Product Analytics in your environment. Create or copy a Product Analytics API key.

Product Analytics uses its own API key. MCP authorization and lakehouse credentials do not replace it.

2. Send an event

Set the API key for the target environment. The key selects the environment:

Terminal

ALTERTABLE_API_KEY='YOUR_PRODUCT_ANALYTICS_API_KEY'
curl https://api.altertable.ai/track \
  -H "X-API-Key: $ALTERTABLE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"event":"Onboarding Test","properties":{},"distinct_id":"onboarding_test_user"}'

3. Find the event

Run this in SQL Explorer:

SQL

SELECT event, distinct_id, timestamp
FROM product_analytics.main.events
WHERE event = 'Onboarding Test'
ORDER BY timestamp DESC
LIMIT 10;

Confirm that the event belongs to onboarding_test_user and has a recent timestamp.

Do this with your agent

Agent prompt

Read https://altertable.ai/docs/getting-started/product-analytics.md for context. Help me set up Altertable Product Analytics for this application. Inspect the framework, ask what behavior I want to measure, propose one event, and verify that the event arrives with the expected identity.

Next, install an SDK in your application to send real events.