Connect Data: Runs
Create Run
Creates a run from an upload, snapshotting its current mapping; status starts as pending and nothing is processed until you start a job on it. With matchOptions null (what the web app and MCP server send), an existing non-failed run of the same upload and mapping is returned instead of a duplicate. 400 if the upload is not found or not yours.
In this section
Authentication
Get API keyBearer token
Send your GTM Scoop API key (llmcp_…) or a signed-in session token as a Bearer token.
Authorization: Bearer YOUR_API_KEYRequest body
application/jsonMounted at
/api/v1/lead-generation
A run is one pass over a mapped upload. Create a run, start enrichment or AI analysis jobs on it (see their own sections), and use these endpoints to list runs and follow their jobs.
Try it in the playground
Signed out: 10 free tries a day with names hidden. Log in for live data.
Open playgroundRelated endpoints