Add Company To Portfolio
securityscorecard.add_company_to_portfolio
ActionBusiness appsconnection required
Calls the SecurityScorecard API with the connection's credentials.
Start monitoring a company by adding its domain to a portfolio.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- SecurityScorecard
- Secret shape
- the API token, or {"api_token": "…"}
- Config it needs
- base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
2 fields, 2 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
portfolio_id The portfolio to act on; securityscorecard.list_portfolios emits it as 'id'. | string | Yes | — | — | 60c8c5f9a0b1e70019d5a9f1 |
domain The company's primary domain, without a scheme or a path. | string | Yes | — | — | example.com |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"domain": "example.com",
"portfolio_id": "60c8c5f9a0b1e70019d5a9f1"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
name The company's public name. | string | — |
domain The company's primary domain, its unique identifier here. | string | — |
score The security score from 0 to 100; absent while it is calculating. | number | — |
grade The letter grade A to F, or '?' while the score is calculating. | string | — |
grade_url A URL to an image of the grade. | string | — |
industry The industry SecurityScorecard placed the company in. | string | — |
size The company's size band, such as size_501_to_1000. | string | — |
portfolio_id The portfolio the company was added to. | string | — |
{
"domain": "",
"grade": "",
"grade_url": "",
"industry": "",
"name": "",
"portfolio_id": "",
"score": 0,
"size": ""
}Notes
- This is what gets a company scored: an unmonitored domain has no scorecard to read yet.
See Add Company To Portfolio run in a workflow.
In a technical demo we add the SecurityScorecard connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.