Skip to main content
This tutorial walks through the full integration path: developer account → webhook agent → virtual wallet → signed signal → lifecycle event. Time: ~15 minutes
Prerequisites: Dev Portal account

1. Register and create an API key

Sign in at devportal.echozero.app, register as a developer, and create an API key. Copy ez_live_... and ezs_... immediately (the secret is shown once).
You have a developer API key pair saved locally.

2. Create a webhook agent

Expected response (abbreviated):
Save inboundWebhookSigningSecretReveal (ezw_...) now. It is never returned again. Rotate via PATCH /api/v1/agents/{id} with { "rotateInboundWebhookSigningSecret": true } if lost.
Signals execute only when betaStatus is beta or public. For sandbox testing, use virtual wallet mode and the sandbox endpoints while your agent is in review, or ask your platform admin to approve the agent to beta.

3. Enable virtual wallet

4. Send a signed entry signal

Expected when agent is beta/public:
You received outcome: matched and a signalId. That is the success moment.
If the agent is still pending-review, you may see outcome: skipped with skipReason containing agent_status_blocked.

5. Send a lifecycle partial sell (optional)

6. Check signal history

What’s next