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

  1. Name the test and set the start URL.
  2. Build the steps (NAVIGATE, TYPE, CLICK, WAIT, READ, ASSERT) — or use the recorder to capture them by clicking through the journey.
  3. End with an ASSERT on stable text/role; store credentials as secrets (reference as {{SECRET}}).
  4. Choose Run from: cloud region(s) or a private agent.
  5. Set the schedule (e.g. every 5–15 min) and save.

API test

  1. Set method, URL, headers, body and auth (bearer/basic/custom header).
  2. Add assertions: status, response time, and JSON body values.
  3. Optionally extract a value to use in a chained next request.
  4. 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.