Resources · n8n integration

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

Why automate

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.

Connect

How do you connect SecurityScorecard to n8n?

  1. 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 > API in 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.

  2. 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.

  3. 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.

Actions

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.

Resources × operations matrix
ResourceCreateGet ManyUpdateDeleteAddRemoveDownloadGenerateGet Factor ScoresGet Historical Factor ScoresGet Historical ScoresGet ScoreGet Information and ScorecardGet Score Plan
Company✓✓✓✓✓
Industry✓✓✓
Invite✓
Portfolio✓✓✓✓
Portfolio Company✓✓✓
Report✓✓✓

Company

5 operations
01

Get a company factor scores and issue counts

company.getFactor

What 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.
Use cases
a supplier review that lists each factor next to its issue count, ready to paste into the vendor file.
02

Get a company's historical factor scores

company.getFactorHistorical

What 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, weekly or monthly.
  • Simplify: returns a simplified version of the response instead of the raw data, handy before writing rows to a sheet.
Use cases
showing whether a supplier flagged at the last audit has moved on the factors that were called out.
03

Get a company's historical scores

company.getHistoricalScore

What 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: monthly for a board slide, daily when something is being watched closely.
  • Return All: off by default, so Limit decides how many points a long window returns.
Use cases
a quarterly chart of every company in the vendor list, rebuilt without anyone opening the platform.
04

Get company information and a summary of their scorecard

company.getScorecard

What 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.
Use cases
enriching an inbound security questionnaire, where the domain arrives from a form and the summary lands in the ticket before a human reads it.
05

Get a company's score improvement plan

company.getScorePlan

What 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.
Use cases
generating the remediation list that goes into a supplier conversation, rather than writing one from memory.

Industry

3 operations
06

Get factor scores for an industry

industry.getFactor

What 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, retail and technology. 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.
Use cases
putting a vendor's factor scores next to their industry before escalating anything.
07

Get historical factor scores for an industry

industry.getFactorHistorical

What 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.
Use cases
answering the question that always follows a drop, which is whether everyone in that sector moved the same way over the same months.
08

Get the score for an industry

industry.getScore

What 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, retail or technology.
Use cases
a reference value fetched once at the start of a reporting workflow and reused by every branch that follows, so the comparison line is fetched rather than typed in by hand each quarter.

Invite

1 operation
09

Create an invite

invite.create

What 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.
Use cases
inviting a new supplier the day the contract is signed, straight from the CRM record.

Portfolio

4 operations
10

Create a portfolio

portfolio.create

What 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: private keeps it visible to you only, team to the people on your team, shared to everyone in your company.
Use cases
a workflow that spins up one portfolio per acquisition or per business unit, named from the record that triggered it.
11

Delete a portfolio

portfolio.delete

What 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 }}.
Use cases
cleaning up the portfolios created for a project once it closes, driven by a list of project codes rather than by memory.
12

Get many portfolios

portfolio.getAll

What 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.
Use cases
a monthly audit that walks every portfolio, counts the companies inside each one, and flags the portfolios nobody has touched since they were created.
13

Update a portfolio

portfolio.update

What 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, team and shared as a portfolio stops being a personal experiment.
Use cases
promoting a portfolio built by one analyst to team visibility once it becomes the reference list.

Portfolio Company

3 operations
14

Add a portfolio company

portfolioCompany.add

What 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.
Use cases
onboarding suppliers in bulk from a signed-vendor list, one item per row, each row carrying the domain. Pair it with a lookup step so a typo in the domain column is caught before the API call rather than after.
15

Get many portfolio companies

portfolioCompany.getAll

What 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: active or inactive.
Use cases
a daily sweep of one portfolio filtered on a named CVE, so exposure is checked without opening a single tab.
16

Remove a portfolio company

portfolioCompany.remove

What 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.
Use cases
offboarding, where a contract end date in the vendor system removes the supplier from the monitored portfolio the same week, instead of leaving it there for a year.

Report

3 operations
17

Download a report

report.download

What 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.
Use cases
attaching the finished file to an email or writing it to storage, without a person downloading it first.
18

Generate a report

report.generate

What 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 summary and detailed to issues, events-json, partnership, full-scorecard-json, portfolio and scorecard-footprint.
  • Scorecard Identifier, Portfolio ID and Date: required alongside the type.
  • Format: csv or pdf.
  • Branding: SecurityScorecard, Company, or both.
Use cases
a quarterly PDF branded for the company and sent to the risk committee.
19

Get many reports

report.getAll

What 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.
Use cases
the middle node of the generate, list, download chain, where the workflow picks the report it just asked for and passes its URL to the download step. Also useful on its own to check nothing has been generated twice in the same week.
Need help

Need help automating SecurityScorecard with n8n?

A person reads every message.

FAQ

SecurityScorecard and n8n, the questions that come up

01Is the SecurityScorecard integration free in n8n?
Yes on the n8n side. The node ships with n8n, so there is nothing to install and no extra n8n cost, whether the workflow runs on n8n Cloud or on a self-hosted instance under the Community Edition and its Sustainable Use licence. A workflow behaves the same way in both cases, which means a setup tested locally moves to Cloud without rewriting anything. What a SecurityScorecard account itself costs is a separate question and is set on their side, not in n8n. The only thing n8n needs from that account is an API key.
02What credentials do you need for the SecurityScorecard node?
One API key. You start from a SecurityScorecard account, then generate the key in one of two ways: as a user, from the API section of the platform settings, or as a bot user, by viewing the bot user and selecting create token. The key is stored once as a SecurityScorecard credential in the n8n Credentials menu and then offered in the node's dropdown, so every workflow on the instance reuses it without the key being pasted anywhere else. A bot user key is the usual choice for automation, since it is not tied to an individual account.
03What are the limits of the SecurityScorecard n8n integration?
Two worth knowing. Pagination is opt-in: on the operations that offer it, Return All has to be switched on for n8n to page through the whole result set, otherwise Limit caps what comes back and a workflow silently works on a partial list. And the node covers 19 operations across 6 resources, so when an endpoint of the SecurityScorecard API has no matching operation here, the HTTP Request node calls that endpoint directly and reuses the same credential through predefined authentication. Nothing else has to be set up for that fallback to work.
04Is there a SecurityScorecard trigger in n8n?
No. This tool has no trigger node in n8n, so a workflow involving it starts with a different trigger. Three usual options: a Schedule Trigger running on a fixed interval, which fits a daily portfolio sweep or a monthly report; an n8n Webhook called by a third-party service, when something outside decides the run should happen, such as a new vendor created in another system; or the trigger of another tool already in the stack. Once the workflow is running, every SecurityScorecard operation behaves exactly the same way as it would after a native trigger.
05n8n or Make for SecurityScorecard?
It depends on four things. Hosting: n8n self-hosts through Docker or npm and also runs on n8n Cloud, while Make is a hosted platform with no self-hosting option. Data control follows from that, which matters when the workflow carries vendor risk data. Cost model: Make bills per operation, so a portfolio sweep that touches many companies has a predictable price shape you can compute in advance. Visual logic differs too, and preference there is genuinely personal. Neither is a bad tool. Read the comparison linked above before committing a whole third-party risk process.