Create a synthetic test
Step-by-step web and API test creation with secrets, agents and schedule.
syntheticscreatewebapirecorderschedule
Create a synthetic test (step by step)
Go to Synthetics → Tests → Create (/synthetic/tests/create) and pick Web or API.
Web (browser) test
- Name the test and set the start URL.
- Build the steps (NAVIGATE, TYPE, CLICK, WAIT, READ, ASSERT) — or use the recorder to capture them by clicking through the journey.
- End with an ASSERT on stable text/role; store credentials as secrets (reference as
{{SECRET}}). - Choose Run from: cloud region(s) or a private agent.
- Set the schedule (e.g. every 5–15 min) and save.
API test
- Set method, URL, headers, body and auth (bearer/basic/custom header).
- Add assertions: status, response time, and JSON body values.
- Optionally extract a value to use in a chained next request.
- Pick agents and a high-frequency schedule (e.g. 30s) for a smoke check.
# API contract example (create -> read back)
POST /v1/orders Assert status==201 Extract orderId = body.id
GET /v1/orders/{{orderId}} Assert status==200 Assert body.status=="confirmed"
Edit later at /synthetic/tests/edit/:testId. Full step model is in Synthetics → Web tests / API tests.