---
title: "Create a customer + website"
description: "This example shows a typical onboarding flow:"
---

1. Create a **customer**
2. Create a **website** for that customer
3. (Optional) Attach monitoring configuration

> If you prefer the UI: you can create customers and websites in the Admin area. The API is useful for automation and bulk setups.

## Prerequisites

- An API token with the required scopes
- Your API base URL (e.g. `https://your-instance.tld`)

See the API introduction first:

- [API Introduction](/api/introduction)

## 1) Create customer

API reference:

- [Customers API](/api/customers)

Example (pseudo request):

```bash
curl -X POST "$API_BASE_URL/api/customers" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme GmbH",
    "email": "ops@deinkunde.com"
  }'
```

Store the returned `customerId`.

## 2) Create website for the customer

API reference:

- [Websites API](/api/websites)

```bash
curl -X POST "$API_BASE_URL/api/websites" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": 123,
    "name": "Acme Marketing Website",
    "url": "https://deinkunde.com"
  }'
```

Important:

- `url` must include the protocol (`https://...`).

## 3) Verify the website

API reference:

- [Get website](/api/websites/get-website)

```bash
curl -X GET "$API_BASE_URL/api/websites/456" \
  -H "Authorization: Bearer $TOKEN"
```

## Next steps

- Configure monitoring behavior per website: [Website Configuration API](/api/website-configuration)
- Learn which monitor types exist: [Monitoring Types](/monitoring/monitoring-types/uptime)