Guide

First ad in 5 minutes

The shortest production-shaped path is key creation, /v1/jobs, /v1/decisions, then beacons.

1. Create keys

Create a test secret key in the dashboard and copy the project client_id. Keep live keys out of local examples.

2. Create a job

Send a POST /v1/jobs request from your backend. The response includes one or more slot IDs.

create-job.sh

curl -X POST https://api.wavebird.ai/v1/jobs \
  -H "Authorization: Bearer sk_test_wavebird_demo_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "wbproj_demo_8jK42",
    "session_id": "sess_demo_123",
    "job_type": "chat",
    "slots_requested": 1,
    "consent": {
      "source": "publisher",
      "purposes": {
        "ads": true,
        "measurement": true
      }
    }
  }'

3. Render and beacon

Poll /v1/decisions/{slot_id}, render the asset when ready, and send render/visibility/click beacons as the user sees the placement.

Troubleshooting

Server-side integration

Code

Create a job

Server API job creation with a secret key.

create-job.sh

curl -X POST https://api.wavebird.ai/v1/jobs \
  -H "Authorization: Bearer sk_test_wavebird_demo_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "wbproj_demo_8jK42",
    "session_id": "sess_demo_123",
    "job_type": "chat",
    "slots_requested": 1,
    "consent": {
      "source": "publisher",
      "purposes": {
        "ads": true,
        "measurement": true
      }
    }
  }'

Need rollout review?

Contact the team

Start in the dashboard, choose Script Tag or Server API, and use contact only when you need rollout review, enterprise coordination, or non-standard integration help. Billing beacon rules live in the API concepts guide.