Skip to content

Getting started

This is the quick tour. For the full technical detail (request/response shapes, validators, transformers), see the API reference.

The idea in one line

You point your senders at an EchoRelay address. EchoRelay authenticates the call, validates it, bills it, and fans it out to one or more destination URLs you configure — retrying any destination that's temporarily down. You build nothing.

1. Create your account and project

  1. Sign up at echorelay.dev and confirm your email.
  2. Create a project. A project is your isolated workspace — its own address, its own key, its own credits.

2. Get your API key

Each project has one key that authenticates every call into it. You'll find it in the panel under your project. There are two kinds:

  • a live key (er_live_…) — uses your paid credits.
  • a test key (er_test_…) — uses a separate free testing allowance, with a lower rate limit, so you can experiment without spending credits.

Keep keys secret. You can rotate them at any time (see Account & security).

3. Define where calls go

In the panel, add an endpoint and give it one or more destinations (the target URLs you want the data delivered to). Add more than one destination and EchoRelay delivers to all of them — that's the fan-out.

You can also attach validation rules so malformed calls are rejected up front. The API reference covers the full set of options.

4. Send your first request

Point your sender at your project's address (shown in the panel) with your key, and send a request. EchoRelay returns quickly (it accepts the call, then delivers in the background) and forwards it to your destination(s).

Test pool first

Use your test key while you're setting things up — it doesn't spend credits. Switch to the live key when you're ready for real traffic.

5. Watch it work

Open your project's request history in the panel to see each call, whether it was delivered, and any retries. If a delivery is failing, When calls fail walks through the fixes.

Next