Skip to content

Integration Nodes ​

Integration nodes connect to third-party platforms and services. Use them to automate PR reviews, feed monitoring, knowledge base updates, issue tracking, and calendar scheduling.

NodeTypeOutput
GitHub Readgithub_readjson
GitHub PR Reviewgithub_pr_reviewjson
GitHub Issue Creategithub_issue_createjson
RSS Feedrss_feedjson
Notion Readnotion_readjson
Notion Writenotion_writejson
Sheets Readgoogle_sheets_readarray
Sheets Writegoogle_sheets_writejson
Calendar Createcalendar_createjson
Linear Issue Createlinear_issue_createjson
Jira Issue Createjira_issue_createjson

GitHub Read ​

Type: github_read · Category: Integrations

Read repository, pull request, issue, or file data from GitHub.

Required Config ​

FieldTypeDescription
repositorystringowner/repo format.

Optional Config ​

FieldTypeDescription
resourcestringpull_request · issue · file · commits.
prNumbernumberPR number (for pull_request resource).
credentialsRefsecretGitHub token secret reference.

Example ​

json
{
  "repository": "ofcskn/lenserfight-web",
  "resource": "pull_request",
  "prNumber": 42
}

Expected output: { "pullRequest": { "title": "Add workflow catalog", "files": 12 } }

Downstream: → github_pr_review

GitHub PR Review · Summarizer · Webhook Trigger


GitHub PR Review ​

Type: github_pr_review · Category: Integrations

Create or draft a GitHub pull request review from analysis output.

Required Config ​

FieldTypeDescription
repositorystringowner/repo format.

Optional Config ​

FieldTypeDefaultOptions
prNumberstring$.pullRequest.number—
reviewBodystring$.summary—
eventstringCOMMENTCOMMENT · APPROVE · REQUEST_CHANGES

Example ​

json
{
  "repository": "ofcskn/lenserfight-web",
  "prNumber": "$.pullRequest.number",
  "reviewBody": "$.summary",
  "event": "COMMENT"
}

Expected output: { "status": "submitted", "reviewId": "PRR_kwDO" }

Downstream: → slack_notify

Valid Connections ​

→ slack_notify, logger, linear_issue_create

GitHub Read · Agent Execute · Summarizer


GitHub Issue Create ​

Type: github_issue_create · Category: Integrations

Create a GitHub issue from workflow output. Use for automated bug reporting, task creation, and workflow failure escalation.

Required Config ​

FieldTypeDescription
repositorystringowner/repo.

Optional Config ​

FieldTypeDescription
titlestringIssue title.
bodystringIssue body or mapping.
labelsjsonLabel array (e.g. ["workflow", "automation"]).

Example ​

json
{
  "repository": "ofcskn/lenserfight-web",
  "title": "Workflow catalog validation failure",
  "body": "$.reasoning",
  "labels": ["workflow", "automation"]
}

Expected output: { "issueNumber": 128, "url": "https://github.com/..." }


RSS Feed ​

Type: rss_feed · Category: Integrations

Fetch RSS feed items. Use for content monitoring, news aggregation, and changelog tracking.

Required Config ​

FieldTypeDescription
feedUrlstringRSS feed URL.

Optional Config ​

FieldTypeDefault
limitnumber10
sincestring—

Example ​

json
{
  "feedUrl": "https://github.blog/feed/",
  "limit": 10,
  "since": "$.lastSuccessfulRun"
}

Expected output: { "items": [{ "title": "Actions update", "link": "https://github.blog/..." }] }

Downstream: → summarizer

Valid Connections ​

→ summarizer, email_send, slack_notify, filter_items, deduplicate


Notion Read ​

Type: notion_read · Category: Integrations

Read Notion pages or database rows.

Required Config ​

FieldTypeDescription
databaseIdstringNotion database id or secret reference.

Optional Config ​

FieldTypeDescription
filterjsonNotion filter object.

Example ​

json
{
  "databaseId": "{{secrets.notionDigestDb}}",
  "filter": { "property": "Status", "equals": "Ready" }
}

Expected output: { "results": [{ "title": "Arena notes" }] }

Downstream: → summarizer


Notion Write ​

Type: notion_write · Category: Integrations

Write a Notion page or database row.

Required Config ​

FieldTypeDescription
databaseIdstringNotion database id.

Optional Config ​

FieldTypeDescription
propertiesjsonPage properties mapping.

Example ​

json
{
  "databaseId": "{{secrets.notionDigestDb}}",
  "properties": { "Name": "$.title", "Summary": "$.summary" }
}

Expected output: { "pageId": "notion_page_123", "url": "https://notion.so/..." }


Sheets Read ​

Type: google_sheets_read · Category: Integrations

Read rows from a Google Sheet.

Required Config ​

FieldTypeDescription
spreadsheetIdstringSheet id or secret reference.

Optional Config ​

FieldTypeDefault
sheetNamestring—
rangestringA1
valueRenderOptionstringFORMATTED_VALUE

Example ​

json
{
  "spreadsheetId": "{{secrets.weeklyMetricsSheet}}",
  "sheetName": "Battle Metrics",
  "range": "A2:G200",
  "valueRenderOption": "FORMATTED_VALUE"
}

Expected output: { "rows": [{ "battleId": "battle_123", "score": 91 }] }

Downstream: → aggregate


Sheets Write ​

Type: google_sheets_write · Category: Integrations

Append or update rows in a Google Sheet.

Required Config ​

FieldTypeDescription
spreadsheetIdstringSheet id or secret reference.

Optional Config ​

FieldTypeDefaultOptions
sheetNamestring——
operationstringappendappend · update
rowsPathstring$.rows—

Example ​

json
{
  "spreadsheetId": "{{secrets.weeklyMetricsSheet}}",
  "sheetName": "Digest Log",
  "operation": "append",
  "rowsPath": "$.rows"
}

Expected output: { "updatedRows": 3 }


Calendar Create ​

Type: calendar_create · Category: Integrations

Create a calendar event using Google Calendar.

Required Config ​

FieldTypeDescription
calendarIdstringCalendar id (e.g. primary).

Optional Config ​

FieldTypeDescription
titlestringEvent title.
startstringISO 8601 start time.
endstringISO 8601 end time.
attendeesjsonAttendee email array.

Example ​

json
{
  "calendarId": "primary",
  "title": "Arena digest review",
  "start": "2026-05-18T10:00:00+03:00",
  "end": "2026-05-18T10:30:00+03:00",
  "attendees": ["founder@example.com"]
}

Linear Issue Create ​

Type: linear_issue_create · Category: Integrations

Create a Linear issue from workflow output.

Required Config ​

FieldTypeDescription
teamIdstringLinear team id or secret reference.

Optional Config ​

FieldTypeDescription
titlestringIssue title.
descriptionstringIssue description or mapping.
prioritynumber1 (urgent) to 4 (low).

Example ​

json
{
  "teamId": "{{secrets.linearTeamId}}",
  "title": "Investigate low-confidence judge result",
  "description": "$.reasoning",
  "priority": 2
}

Jira Issue Create ​

Type: jira_issue_create · Category: Integrations

Create a Jira issue from workflow output.

Required Config ​

FieldTypeDescription
projectKeystringJira project key (e.g. LF).

Optional Config ​

FieldTypeDescription
issueTypestringTask · Bug · Story
summarystringIssue summary.
descriptionstringDescription or mapping.

Example ​

json
{
  "projectKey": "LF",
  "issueType": "Task",
  "summary": "Workflow validation warning",
  "description": "$.warning"
}

See also: Node Catalog Index · Storage Nodes · Communication Nodes · Workflow Studio