Create and manage New Relic Synthetics monitors via the NerdGraph GraphQL API
domain: docs.newrelic.com/docs/apis/nerdgraph/examples/nerdgraph-synthetics-tutorial · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
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
Known 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
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?