Prerequisites
- A Glyph workspace — start free, no card required.
- Node.js 18+ (browser or Node SDK) or Python 3.9+ (Python SDK).
Get started
1
Get a write key
In your workspace, switch to Test, then open Settings → SDK keys. Click Create key, name it (for example,
Local development), choose whether it will be used by a server, browser, direct HTTP integration, or backfill, and copy the value.glyph_test_...— sends events to your workspace’s isolated test environment. Use this to verify an integration without touching live data.glyph_pk_...— sends live customer traffic. Use this in production.
GLYPH_WRITE_KEY. Create a separate live key when the integration is ready for production.2
Install an SDK
3
Send a profile and an event
Send the profile first, then record an event. Messages are queued locally and sent in batches.
userId is the stable identity key. Every profile must include email.flush() sends the current queue immediately. Call it before a script or serverless function exits.4
Verify in Glyph
Open your workspace and switch to the test environment. The customer profile and event should appear on the same timeline. Test traffic never mixes with live customer data.If nothing appears, check the key’s last used value in Settings. A value of “never” means Glyph has not received a request for that key. See Troubleshooting for the next checks.
Next steps
What to capture
Choose events and traits that add useful customer context.
Configuration & delivery
Batching, flush behavior, retries, and error handling across SDKs.