Create a customer + website
End-to-end example: create a customer and then create the first website.
Create a customer + website
This example shows a typical onboarding flow:
- Create a customer
- Create a website for that customer
- (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:
1) Create customer
API reference:
Example (pseudo request):
curl -X POST "$API_BASE_URL/api/customers" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme GmbH",
"email": "ops@acme.example"
}'
Store the returned customerId.
2) Create website for the customer
API reference:
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://acme.example"
}'
Important:
urlmust include the protocol (https://...).
3) Verify the website
API reference:
curl -X GET "$API_BASE_URL/api/websites/456" \
-H "Authorization: Bearer $TOKEN"
Next steps
- Configure monitoring behavior per website: Website Configuration API
- Learn which monitor types exist: Monitoring Types