Skip to main content
This guide sends a customer profile and event to a new Glyph workspace. To use a coding agent for the integration, see Set up with AI.

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 SettingsSDK 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 shows the full key only when it is created or rotated. Store server-side keys in an environment variable such as 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. userId is the stable identity key. Every profile must include email.
Messages are queued locally and sent in batches. 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.
Stuck? Email hello@glyph.app and a founder answers.