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