Skip to main content

Integration Nodes Reference

Integration nodes connect your workflows to external services and APIs.


API Request Node

Make HTTP requests to any external API with full control over method, headers, authentication, and body.

Configuration

FieldTypeRequiredDescription
URLTextYesTarget URL (supports variables)
MethodSelectYesGET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
Query ParamsObjectNoURL query parameters
HeadersObjectNoRequest headers
BodyText/JSONNoRequest body content
Body Content TypeSelectNojson, form, text, xml
Auth TypeSelectNonone, basic, bearer, api_key
TimeoutNumberNoRequest timeout (1-300 seconds, default 30)
Max RetriesNumberNoRetry attempts on failure (0-10, default 3)
Follow RedirectsToggleNoFollow HTTP redirects (default true)

Authentication Options

None:

No authentication headers added

Basic Auth:

Auth Type: basic
Username: {{username}}
Password: {{password}}

Bearer Token:

Auth Type: bearer
Token: {{api_token}}

API Key:

Auth Type: api_key
Header Name: X-API-Key
API Key: {{api_key}}

Example: POST JSON

URL: https://api.example.com/users
Method: POST
Headers: {"Content-Type": "application/json"}
Body: {
"name": "{{contact.first_name}}",
"email": "{{contact.email}}"
}

Output Variables

{{apirequest_1.data}}           - Response body (parsed JSON or text)
{{apirequest_1.status}} - HTTP status code
{{apirequest_1.headers}} - Response headers
{{apirequest_1.success}} - true if 2xx status
{{apirequest_1.error}} - Error message if failed

Google Sheets Node

Read from, write to, and manage Google Sheets spreadsheets.

Configuration

FieldTypeRequiredDescription
IntegrationSelectYesGoogle Sheets OAuth integration
OperationSelectYesOperation to perform
Spreadsheet URLTextConditionalFull Google Sheets URL
Spreadsheet IDTextConditionalAlternative to URL
Range NameTextConditionalA1 notation (e.g., Sheet1!A1:C10)
ValuesArrayConditional2D array for write/append
TitleTextConditionalFor create operations

Operations

OperationDescriptionRequired Fields
read_rangeRead data from rangespreadsheet_id/url, range_name
write_rangeWrite data to rangespreadsheet_id/url, range_name, values
append_rowsAdd rows at endspreadsheet_id/url, range_name, values
clear_rangeClear data in rangespreadsheet_id/url, range_name
create_spreadsheetCreate new spreadsheettitle
add_sheetAdd sheet to spreadsheetspreadsheet_id/url, title
list_spreadsheetsList accessible sheets(optional) query

Example: Append Rows

Operation: append_rows
Spreadsheet URL: https://docs.google.com/spreadsheets/d/ABC123/edit
Range Name: Sheet1!A:D
Values: [
["{{contact.name}}", "{{contact.email}}", "{{contact.phone}}", "{{date}}"]
]

Output Variables

{{googlesheets_1.data}}            - Read data (2D array)
{{googlesheets_1.spreadsheet_id}} - Spreadsheet ID
{{googlesheets_1.updated_range}} - Range that was updated
{{googlesheets_1.updated_rows}} - Number of rows affected
{{googlesheets_1.success}} - true/false

Google Calendar Node

Create, update, delete, and query Google Calendar events.

Configuration

FieldTypeRequiredDescription
IntegrationSelectYesGoogle Calendar OAuth integration
OperationSelectYesOperation to perform
Calendar IDTextNoCalendar ID (default: primary)
SummaryTextConditionalEvent title
Start TimeTextConditionalISO 8601 format
End TimeTextConditionalISO 8601 format
AttendeesArrayNoList of email addresses
DescriptionTextNoEvent description
LocationTextNoEvent location
Event IDTextConditionalFor update/delete

Operations

OperationDescriptionRequired Fields
create_eventCreate new eventsummary, start_time, end_time
update_eventUpdate existing eventevent_id, fields to update
delete_eventDelete eventevent_id
get_eventsList events(optional) time range
check_availabilityFind free slotsstart_time, end_time

Example: Create Meeting

Operation: create_event
Summary: Meeting with {{contact.first_name}}
Start Time: 2024-03-20T10:00:00-05:00
End Time: 2024-03-20T11:00:00-05:00
Attendees: ["{{contact.email}}"]
Description: Discuss {{deal.name}} proposal
Location: Zoom - {{meeting_link}}

Output Variables

{{googlecalendar_1.event_id}}      - Created/updated event ID
{{googlecalendar_1.html_link}} - Link to event
{{googlecalendar_1.events}} - Array of events (for get_events)
{{googlecalendar_1.busy_slots}} - Busy times (for check_availability)
{{googlecalendar_1.success}} - true/false

Apollo Search & Enrich Node

Search for prospects and enrich contact/company data using Apollo.io.

Configuration

FieldTypeRequiredDescription
IntegrationSelectYesApollo.io integration
OperationSelectYesOperation to perform
QueryTextConditionalSearch keywords
LimitNumberNoMax results (1-100, default 25)
PageNumberNoPagination (1-500)

Operations

OperationDescription
search_peopleFind people by criteria
search_companiesFind companies by criteria
enrich_personEnrich contact data
enrich_companyEnrich company data
bulk_enrich_peopleBatch person enrichment
bulk_enrich_companiesBatch company enrichment
find_emailFind email for person
verify_emailVerify email deliverability

Search Filters

Query: "Software Engineer"
Job Titles: ["CTO", "VP Engineering"]
Company Size: ["11-50", "51-200"]
Industries: ["Technology", "SaaS"]
Locations: ["San Francisco", "New York"]

Output Variables

{{apollosearch_1.people}}          - Array of people results
{{apollosearch_1.companies}} - Array of company results
{{apollosearch_1.enriched_data}} - Enriched record data
{{apollosearch_1.email}} - Found/verified email
{{apollosearch_1.total_results}} - Total matches
{{apollosearch_1.success}} - true/false

VAPI Voice Call Node

Trigger AI-powered voice calls using VAPI.

Configuration

FieldTypeRequiredDescription
IntegrationSelectYesVAPI integration
OperationSelectYesOperation to perform
Phone NumberTextConditionalE.164 format (+1234567890)
Customer NameTextNoName for personalization
Assistant IDTextConditionalVAPI assistant to use

Operations

OperationDescription
trigger_callStart outbound call
get_call_statusCheck call status
get_call_recordingGet recording URL
get_call_transcriptGet call transcript
get_call_summaryGet AI summary
list_callsList recent calls
batch_callsTrigger multiple calls

Example: Trigger Call

Operation: trigger_call
Phone Number: {{contact.phone}}
Customer Name: {{contact.first_name}}
Assistant ID: asst_abc123

Output Variables

{{vapicall_1.call_id}}             - Call identifier
{{vapicall_1.status}} - Call status
{{vapicall_1.recording_url}} - Recording URL
{{vapicall_1.transcript}} - Call transcript
{{vapicall_1.summary}} - AI-generated summary
{{vapicall_1.duration}} - Call duration
{{vapicall_1.success}} - true/false

MCP Tool Node

Execute tools from MCP (Model Context Protocol) servers.

Configuration

FieldTypeRequiredDescription
MCP ServerSelectYesMCP server integration
Tool NameTextYesName of tool to execute
ArgumentsObjectNoTool arguments (supports variables)
TimeoutNumberNoExecution timeout (default 30s)
Output FormatSelectNotext, json, raw

Example: File System Tool

MCP Server: filesystem-server
Tool Name: read_file
Arguments: {
"path": "/data/{{filename}}.json"
}

Example: Database Tool

MCP Server: postgres-server
Tool Name: query
Arguments: {
"sql": "SELECT * FROM users WHERE email = '{{email}}'"
}

Output Variables

{{mcptool_1.content}}        - Tool output content
{{mcptool_1.text}} - Text representation
{{mcptool_1.success}} - true/false
{{mcptool_1.error}} - Error message if failed

Tableau Chart Node

Generate charts using Tableau Server and VizQL Data Service.

Configuration

FieldTypeRequiredDescription
IntegrationSelectYesTableau Server integration
Datasource IDTextYesTableau datasource ID
SQL QueryTextYesQuery for chart data
Chart TypeSelectYesbar, line, pie, scatter, area, heatmap
Chart ConfigObjectNoAdditional chart configuration

Output Variables

{{tableauchart_1.chart_url}}       - Embedded chart URL
{{tableauchart_1.data}} - Query result data
{{tableauchart_1.success}} - true/false

Tableau WDC Node

Generate charts using Tableau Web Data Connector approach.

Configuration

FieldTypeRequiredDescription
Database IntegrationSelectYesDatabase connection
Tableau IntegrationSelectNoTableau Server (optional)
SQL QueryTextYesQuery to execute
Chart NameTextNoName for the chart

Output Variables

{{tableauwdc_1.wdc_url}}           - Web Data Connector URL
{{tableauwdc_1.data}} - Query result data
{{tableauwdc_1.success}} - true/false

Quick Reference

Node Selection Guide

NeedUse
Call any REST APIAPI Request
Google Sheets operationsGoogle Sheets
Calendar/meetingsGoogle Calendar
Sales prospectingApollo Search & Enrich
AI voice callsVAPI Voice Call
MCP server toolsMCP Tool
Tableau visualizationsTableau Chart / WDC

Common Patterns

API Integration:

[Trigger] → [API Request: Fetch data] → [Transform] → [CRM Manager: Update]

Sheet Logging:

[Any Trigger] → [Google Sheets: Append row with details]

Meeting Scheduling:

[Form Submit] → [Google Calendar: Check availability]
→ [Google Calendar: Create event]
→ [Email Send: Confirmation]

Lead Enrichment:

[New Contact] → [Apollo: Enrich person]
→ [CRM Manager: Update contact with enriched data]

Error Handling

Always check success and handle failures:

[API Request] → [Condition: {{apirequest_1.success}}]
→ true → [Continue workflow]
→ false → [Log error] → [Notify team]

Best Practices

  1. Use variables in URLs - Build dynamic endpoints with {{node.field}}
  2. Set appropriate timeouts - Prevent hanging on slow APIs
  3. Handle rate limits - Use delays between bulk operations
  4. Secure credentials - Use integrations, not hardcoded keys
  5. Log API calls - Track requests for debugging