Make
Run coSPEC agents from Make.com scenarios
Overview
The coSPEC Make integration lets you start agent runs from any scenario. Because Make has a 5-minute module timeout and agent runs can last much longer, results arrive in a separate scenario via the "Run Finished" trigger — not in the same scenario that started the run.
Prerequisites
- coSPEC account with an API key (
csk_live_...) — see API Keys - Make.com account (any plan)
Install
coSPEC is currently a private app (invite-only).
Accept Make Invite →- Click the button above
- Click Install
- The coSPEC app appears in your Make.com account
- Search "coSPEC" when adding modules to scenarios
Connect Your API Key
- In a scenario, add a coSPEC module
- Click Create a connection
- Paste your API key (
csk_live_...) - Make validates the key automatically
Where to find your key: Dashboard → API Keys → Create API Key
Modules
Create Run
Agent runs last minutes to hours. Make.com has a 5-minute module timeout, so a single scenario can't wait. Results arrive via a separate scenario with the "Run Finished" trigger.
Scenario 1 — Start the run:
[Your Trigger] → [coSPEC: Create Run]Scenario 2 — Receive results:
[coSPEC: Run Finished] → [Your Actions (Slack, Jira, etc.)]When you add the "Run Finished" trigger, Make automatically registers a webhook with coSPEC. When any run finishes, coSPEC delivers the results to that webhook — you never see or copy any URL.
Correlating across scenarios: Use the Metadata field on Create Run to pass context (e.g. slackChannel: C123). The metadata is echoed in the Run Finished payload so Scenario 2 can route results back to the right place.
Get Run
Action module — fetch a run by ID. Returns the full run object with all output fields. Use it in Scenario 2 after the Run Finished trigger if you need additional run details.
Run Finished Trigger
Instant trigger — fires when a run reaches a terminal state.
- Events: Completed, Failed, Cancelled (multi-select, default: all)
- The webhook is registered automatically when you add the trigger
- Delivers the full run object including outputs, usage, and metadata
Output Fields
These fields are available from the Run Finished trigger (Scenario 2) and the Get Run module — not from Create Run (which only returns the run ID).
The run output is parsed into convenience fields for easy mapping. These extract the first output of each type — for example, PR URL is the first pull request. If a run produces multiple outputs, use the raw Outputs JSON field for the full list.
| Field | Description |
|---|---|
| Output: PR URL | URL of the first pull request |
| Output: PR Title | Title of the first pull request |
| Output: PR Number | Number of the first pull request |
| Output: Branch Name | Name of the created branch |
| Output: Issue URL | URL of the first issue |
| Output: Issue Title | Title of the first issue |
| Output: Issue Number | Number of the first issue |
| Output: Summary | Human-readable summary, e.g. PR #42: Fix login bug, Branch: fix/login-bug |
| Outputs JSON | Raw outputs array for runs with multiple outputs |
Failed Runs
When a run fails, the Status field is failed. Two additional fields help you diagnose:
- Fail Reason — why the run stopped:
max_turns,max_cost,timeout, orerror - Error — error details (message and code) when
failReasoniserror
These fields are available in the Run Finished trigger payload and Get Run output.
Troubleshooting
| Issue | Solution |
|---|---|
| Module timeout error | Expected if you're trying to wait for results in one scenario. Use the two-scenario pattern with Run Finished trigger. |
| Run Finished doesn't fire | Check that Scenario 2 is active. The webhook is only registered when the scenario is on. |
| Connection error | Verify your API key. Keys start with csk_live_. |