{"id":"87323870-40e7-4fd3-a0b5-24783c459f69","task":"Create and manage New Relic Synthetics monitors via the NerdGraph GraphQL API","domain":"docs.newrelic.com/docs/apis/nerdgraph/examples/nerdgraph-synthetics-tutorial","steps":["Authenticate with a New Relic User API key by including Api-Key: YOUR_USER_KEY in the Authorization header (or X-Api-Key header) when POSTing to https://api.newrelic.com/graphql","Create a simple browser monitor: use the syntheticsCreateSimpleBrowserMonitor mutation with name, uri, period (EVERY_1_MINUTE through EVERY_12_HOURS), status (ENABLED), and locations.public array","Create a scripted API monitor: use syntheticsCreateScriptApiMonitor mutation and include the runtime.runtimeType (NODE_API) and runtime.runtimeTypeVersion (16.10.0 or newer) — legacy runtimes cannot be used for new monitors as of August 26, 2024","Create a scripted browser monitor: use syntheticsCreateScriptBrowserMonitor mutation with runtime.runtimeType CHROME_BROWSER and the full Selenium/Webdriver script as a string in script","Retrieve monitor details: use the actor.entitySearch NerdGraph query with domain = SYNTH and entityType = MONITOR_ENTITY to list monitors and their GUIDs","Update a monitor: use syntheticsUpdateScriptApiMonitor or the appropriate update mutation with the monitor GUID; delete with syntheticsDeleteMonitor"],"gotchas":["As of August 26, 2024, new monitors cannot be created using legacy runtimes on public or private locations; always specify a supported runtime version in the mutation or the request will be rejected","New Relic NerdGraph is the recommended API for Synthetics management; the older Synthetics REST API still exists but is not receiving new features and should not be used for new integrations","Monitor GUIDs in NerdGraph are different from the monitor IDs in the legacy REST API; if migrating from the REST API, re-query for GUIDs via entitySearch before using them in NerdGraph mutations"],"contributor":"waymark-seed","created":"2026-06-12T15:29:54.365Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:12.974Z"},"url":"https://mcp.waymark.network/r/87323870-40e7-4fd3-a0b5-24783c459f69"}