# Quickstart

> Send your first event, win a sandbox reward, and open the Rewards Hub. About 10 minutes.

Source: https://docs.onari.xyz/docs/quickstart

Everything here happens in **sandbox**: no real players, no real money, nothing your customers can see.

<Steps>
<Step>

### Get a sandbox key

In the dashboard, switch to **Sandbox** (top right), then go to **Developers → API keys → New key**. Copy the key (`sk_test_…`); it's shown once. Keep it on your server only.

```bash
export ONARI_KEY=sk_test_...
```

</Step>
<Step>

### Check your events list

Go to **Developers → Events**. Your workspace starts with the usual events for your industry (for example `order.placed`, `transfer.completed` or `airtime.recharged`). Add your own if something's missing. Onari only accepts event types on this list, which catches typos early.

</Step>
<Step>

### Launch a sandbox challenge

Go to **Campaigns → New campaign**. Pick a challenge such as "do `order.placed` 2 times", choose a reward (cashback is the simplest to test), set a small budget, and launch it.

</Step>
<Step>

### Send events

```bash
curl https://api.onari.xyz/v1/events \
  -H "Authorization: Bearer $ONARI_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "order.placed", "player_id": "test_player_1", "amount": 1250000 }'
```

The response shows the player's progress. Send it a second time and the response includes the reward:

```json
{
  "event_id": 1042,
  "player_id": "test_player_1",
  "campaigns": [{ "campaign_id": "6f1c…", "progress": 2, "goal": 2 }],
  "rewards": [{ "id": "a91e…", "campaign": "Weekend challenge", "reason": "challenge", "kind": "cashback", "value": 50000, "currency": "NGN", "status": "issued" }]
}
```

</Step>
<Step>

### Receive the webhook

In **Developers → Webhooks**, add a URL (a request-bin site works for a first look) and click **Send a test**. Win again with another player ID and you'll see `reward.issued` arrive. See [Webhooks](/docs/webhooks) to handle it properly.

</Step>
<Step>

### Open the Rewards Hub

```bash
curl https://api.onari.xyz/v1/hub/sessions \
  -H "Authorization: Bearer $ONARI_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "player_id": "test_player_1" }'
```

Open the `url` from the response in a browser: that's what your customer sees inside your app. Or use **Rewards Hub → Try your Hub** in the dashboard.

</Step>
</Steps>

## Going live

Create a **live** key (`sk_live_…`), set a live webhook URL, and launch your campaign in live. Sandbox and live share nothing: players, campaigns, keys and webhooks are separate.