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