Quickstart

Quickstart

From signup to deployed site in five minutes. Every step is a copy-paste.

1. Get an API key

  1. Sign up at app.warpweb.ai.
  2. Confirm your email (magic link).
  3. Open API Keys in the dashboard and create a key. You’ll see two prefixes:
    • wpwb_pk_… — publishable, safe to expose in client code (read-only operations).
    • wpwb_sk_… — secret, server-side only. Use this for the quickstart.

The plaintext key is shown once at creation. Store it in your secret manager.

export WARPWEB_KEY="wpwb_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

2. Buy credits

The starter pack is $5 — enough for a few builds while you experiment. Hit Billing → Add Credits in the dashboard.

A build costs ~150 credits ($1.50). See Pricing & Credits for the full table.

3. Build your first site

curl -X POST https://api.warpweb.ai/v1/sites \
  -H "Authorization: Bearer $WARPWEB_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Brookside Plumbing",
    "business_location": "Austin, TX",
    "business_type": "Residential plumbing services",
    "contact_email": "owner@brooksideplumbing.com"
  }'

Response:

{
  "site_id": "site_8f3c2a1b-5d47-4c9e-b820-1f8a3e7d9c4f",
  "status": "building",
  "created_at": "2026-05-17T14:23:11Z"
}

The build runs asynchronously — research, copy, design, deploy. Typical time to deployed URL: 60-120 seconds.

4. Poll for the deployed URL

curl https://api.warpweb.ai/v1/sites/site_8f3c2a1b-5d47-4c9e-b820-1f8a3e7d9c4f \
  -H "Authorization: Bearer $WARPWEB_KEY"

Response once the site is live:

{
  "site_id": "site_8f3c2a1b-5d47-4c9e-b820-1f8a3e7d9c4f",
  "status": "live",
  "deployed_url": "https://brookside-plumbing.warpweb.app",
  "hosting_tier": "free_subdomain",
  "created_at": "2026-05-17T14:23:11Z",
  "deployed_at": "2026-05-17T14:24:38Z"
}

Poll every 5-10 seconds while status is building. Or skip polling and configure a revision-status webhook to get notified.

Open the deployed_url in your browser. That’s a real, indexed, working website.

5. Configure a webhook for form submissions

The generated site has a contact form. You probably want submissions in your own system.

curl -X POST https://api.warpweb.ai/v1/sites/site_8f3c2a1b/webhooks/forms \
  -H "Authorization: Bearer $WARPWEB_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://api.yourapp.com/webhooks/warpweb-leads",
    "secret": "whsec_pickAnythingLongAndRandom"
  }'

Now every form submission POSTs to your URL with an HMAC-SHA256 signature. See Webhooks → Form Submissions for the payload shape and signature verification.

6. Submit a test form

Visit the site’s contact form in your browser, fill it in, submit. Your webhook fires within seconds. If the receiver returns 5xx or times out, Warpweb retries on a schedule: immediate → 30s → 5min, then dead-letters.

What’s next

WelcomeAuthentication