- Home
- Resources
- Integrations
- SecurityScorecard
SecurityScorecard n8n integrationAutomate SecurityScorecard with n8n.
Third-party risk data is only useful once it leaves the platform. The SecurityScorecard n8n integration covers 19 operations across 6 resources: company scorecards, industry figures, portfolios, invites and report files. No trigger node ships with it, so another trigger starts the run.
Verified Trustpilot reviews · AI, automation & growth agency
What does the SecurityScorecard n8n integration actually give you?
The SecurityScorecard n8n integration is the built-in node that talks to the SecurityScorecard API from inside a workflow. It reads a company scorecard and its factor scores, reads the same figures for an industry, manages portfolios and the companies inside them, sends an invite, and generates then downloads a report file. Every operation runs on one API key credential you set up once.
Start with the reading side. company.getScorecard returns company information and a summary of their scorecard for one identifier, usually a domain. company.getFactor breaks the same company down factor by factor with the issue counts behind each one, and the two historical operations replay those numbers across a date range at daily, weekly or monthly granularity. That is enough to turn a vendor review into a scheduled workflow that writes a row per supplier into Google Sheets instead of a screenshot pasted into a deck.
The portfolio resource is where monitoring at scale lives. A portfolio is created, renamed and deleted from the node, companies are added by domain and removed the same way, and portfolioCompany.getAll lists what is inside with filters on grade, industry, issue type, status and CVE vulnerability. A workflow that reads a portfolio every morning and pushes anything matching a filter into Slack replaces the habit of logging in to check.
Reports close the loop. report.generate asks the platform for one of 8 report types, report.getAll lists recently generated reports, and report.download pulls the file into a binary field so the next node can attach it to an email or drop it in storage. The public template at n8n.io/workflows/920 chains those three in that order. Feed the same figures into Grafana for a panel the security team already watches, or hand an issue over to Cortex when the follow-up is an analysis job.
Two things shape how workflows get built here. There is no SecurityScorecard trigger node, so a run starts from a Schedule Trigger on a fixed interval, from an n8n Webhook called by another service, or from another tool's trigger. And when an endpoint of the API has no matching operation on the node, the HTTP Request node calls it directly while reusing the same credential through predefined authentication. Worth reading the n8n review before committing a whole risk process to it.
How do you connect SecurityScorecard to n8n?
- 01
Create the API key
You need a SecurityScorecard account first. From there an API key is generated in one of two ways: as a user, from
My Settings > APIin the platform, or as a bot user, by viewing the bot user and selecting create token. The bot user route keeps the key attached to an automation rather than to a person who might leave the company. - 02
Store it as an n8n credential
In n8n, open the Credentials menu and add a SecurityScorecard credential, which asks for the API Key you just generated. A credential is created once and reused by every workflow on the instance, so the key is never pasted into a node. The node then offers that credential in its own dropdown when you drop it on the canvas.
- 03
Run one read operation
Pick the Company resource and the Get Information and Scorecard operation, then put a domain you own into Scorecard Identifier and execute the node alone. A successful run proves the key, the account and the scorecard access all line up before any portfolio or report logic gets built on top of it.
What can the SecurityScorecard node do?
The SecurityScorecard node exposes 19 operations across 6 resources. For each one: the node as you configure it in n8n, the required fields, and our field notes.
| Resource | Create | Get Many | Update | Delete | Add | Remove | Download | Generate | Get Factor Scores | Get Historical Factor Scores | Get Historical Scores | Get Score | Get Information and Scorecard | Get Score Plan |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Company | ✓ | ✓ | ✓ | ✓ | ✓ | |||||||||
| Industry | ✓ | ✓ | ✓ | |||||||||||
| Invite | ✓ | |||||||||||||
| Portfolio | ✓ | ✓ | ✓ | ✓ | ||||||||||
| Portfolio Company | ✓ | ✓ | ✓ | |||||||||||
| Report | ✓ | ✓ | ✓ |
Operations index
Company
5 operationsGet a company factor scores and issue counts
company.getFactorWhat you see in n8n
Notes & use cases
Returns the factor scores for one company along with the issue counts behind them, so a review has something more actionable than a single headline figure.
Key parameters
- Scorecard Identifier: the primary identifier of a company or scorecard, meaning a domain. Coming from an earlier node, reference it with
{{ $json.field }}. - Severity In: an optional filter that keeps only issues matching a comma-separated severity list.
- Return All: on, n8n walks every page of factor results; off, Limit caps how many come back.
Get a company's historical factor scores
company.getFactorHistoricalWhat you see in n8n
Notes & use cases
Same factor-level detail, replayed across a period instead of a single snapshot, which is what a trend needs.
Key parameters
- Scorecard Identifier: the company or scorecard identifier, a domain.
- Date From and Date To: the start and end of the history window.
- Timing: date granularity, either
daily,weeklyormonthly. - Simplify: returns a simplified version of the response instead of the raw data, handy before writing rows to a sheet.
Get a company's historical scores
company.getHistoricalScoreWhat you see in n8n
Notes & use cases
Pulls the company's scores over time rather than the factor breakdown, one series for the whole scorecard.
Key parameters
- Scorecard Identifier: the domain of the company being tracked.
- Date From and Date To: the history start and end dates.
- Timing:
monthlyfor a board slide,dailywhen something is being watched closely. - Return All: off by default, so Limit decides how many points a long window returns.
Get company information and a summary of their scorecard
company.getScorecardWhat you see in n8n
Notes & use cases
One call, one company: the company information plus a summary of their scorecard. It is the operation to reach for when a workflow needs context about a domain rather than a deep dive.
Key parameters
- Scorecard Identifier: the primary identifier of a company or scorecard, in practice its domain, and the only field the operation requires.
Get a company's score improvement plan
company.getScorePlanWhat you see in n8n
Notes & use cases
Asks SecurityScorecard what it would take for a company to reach a score you name, and returns that improvement plan.
Key parameters
- Scorecard Identifier: the domain of the company the plan is built for.
- Score: the score target, a number, and the field that makes this operation different from the other Company reads.
- Return All: on, every step of the plan is returned; off, Limit truncates the list.
Industry
3 operationsGet factor scores for an industry
industry.getFactorWhat you see in n8n
Notes & use cases
Moves the same factor view up a level, from one company to a whole industry, which gives a company reading somewhere to sit.
Key parameters
- Industry: a fixed list of 5 choices,
food,healthcare,manofacturing,retailandtechnology. The spelling of the manufacturing value is the node's own, so copy it as shown. - Simplify: returns a simplified response instead of the raw data.
- Return All: paginates through the full result set instead of stopping at Limit.
Get historical factor scores for an industry
industry.getFactorHistoricalWhat you see in n8n
Notes & use cases
The industry factor view over a window of time, so a movement on one supplier can be checked against the sector rather than read alone.
Key parameters
- Industry: one of the 5 values the node offers.
- Date From and Date To: the history start and end dates for this operation.
- Simplify: a simplified version of the response instead of the raw data.
Get the score for an industry
industry.getScoreWhat you see in n8n
Notes & use cases
The lightest call on the node: an industry goes in, its score comes out, with nothing else to configure.
Key parameters
- Industry: the only field, picked from
food,healthcare,manofacturing,retailortechnology.
Invite
1 operationCreate an invite
invite.createWhat you see in n8n
Notes & use cases
Creates an invite for a company or user, which is how a supplier gets brought onto the platform from a workflow instead of by hand.
Key parameters
- Email, First Name and Last Name: the invitee, all three required.
- Message: the message for the invitee, also required, so it needs real text and not a placeholder.
- Domain: one of 9 additional fields, holding the invitee company domain.
- Grade to Maintain: requests the invitee's organisation to maintain a minimum grade.
Portfolio
4 operationsCreate a portfolio
portfolio.createWhat you see in n8n
Notes & use cases
Creates a portfolio, the container that companies are later added to and monitored in.
Key parameters
- Portfolio Name: the name of the portfolio, the only required field.
- Description: free text, worth filling when several portfolios share similar names.
- Privacy:
privatekeeps it visible to you only,teamto the people on your team,sharedto everyone in your company.
Delete a portfolio
portfolio.deleteWhat you see in n8n
Notes & use cases
Removes a portfolio from the account. There is no confirmation step inside the node, so the workflow itself has to be sure.
Key parameters
- Portfolio ID: the identifier of the portfolio, not its name. Get Many portfolios first if only the name is known, then pass the identifier along with
{{ $json.field }}.
Get many portfolios
portfolio.getAllWhat you see in n8n
Notes & use cases
Lists the portfolios on the account, which is how most workflows resolve a portfolio name into the identifier every other portfolio operation needs.
Key parameters
- Return All: on, n8n pages through every portfolio; off, Limit sets the maximum number returned.
Update a portfolio
portfolio.updateWhat you see in n8n
Notes & use cases
Changes an existing portfolio rather than creating a second one next to it.
Key parameters
- Portfolio ID: which portfolio gets updated.
- Portfolio Name: required here too, so the name is always sent, even when only the description is changing.
- Privacy: switch between
private,teamandsharedas a portfolio stops being a personal experiment.
Portfolio Company
3 operationsAdd a portfolio company
portfolioCompany.addWhat you see in n8n
Notes & use cases
Puts a company inside a portfolio so it gets monitored with the rest of the group.
Key parameters
- Portfolio ID: the portfolio receiving the company.
- Domain: the company's domain name, which is what identifies it here.
Get many portfolio companies
portfolioCompany.getAllWhat you see in n8n
Notes & use cases
Reads the companies inside one portfolio, with 5 filters available to narrow the list before it reaches the next node.
Key parameters
- Portfolio ID: the portfolio being read.
- Grade, Industry and Issue Type: filters on company score grade, industry and issue type.
- Vulnerability: a CVE vulnerability filter.
- Status:
activeorinactive.
Remove a portfolio company
portfolioCompany.removeWhat you see in n8n
Notes & use cases
Takes a company out of a portfolio. The company itself is untouched, only its membership of that portfolio ends.
Key parameters
- Portfolio ID: the portfolio the company leaves.
- Domain: the company's domain name, matching the one used when it was added.
Report
3 operationsDownload a report
report.downloadWhat you see in n8n
Notes & use cases
Fetches a report that has already been generated and hands the file to the next node as binary data.
Key parameters
- Report URL: the report file path or HTTPS download URL from the SecurityScorecard API at
api.securityscorecard.io. - Put Output File in Field: the name of the output binary field the file goes into, which the following node reads by that exact name.
Generate a report
report.generateWhat you see in n8n
Notes & use cases
Asks the platform to build a report. Generation and retrieval are separate steps, which is why the public template chains generate, list and download.
Key parameters
- Report: 8 types, from
summaryanddetailedtoissues,events-json,partnership,full-scorecard-json,portfolioandscorecard-footprint. - Scorecard Identifier, Portfolio ID and Date: required alongside the type.
- Format:
csvorpdf. - Branding: SecurityScorecard, Company, or both.
Get many reports
report.getAllWhat you see in n8n
Notes & use cases
Returns the list of recently generated reports, which is the step between asking for a report and downloading it.
Key parameters
- Return All: on, the whole list comes back page by page; off, Limit keeps it to the most recent few.
Need help automating SecurityScorecard with n8n?
A person reads every message.

