Zum Hauptinhalt springen

Integration

Category: Integration
Node id: integration

Integrates with third-party services: Slack, Stripe, Twilio, SendGrid, GitHub, or custom HTTP

What it does​

  • Slack integration: post messages, create channels, invite users
  • Stripe integration: create customers, payment intents, get customer details
  • Twilio integration: send SMS, make phone calls
  • SendGrid integration: send transactional emails
  • GitHub integration: create issues, pull requests, get repository info
  • Custom HTTP integration with configurable URL, method, and headers
  • Response duration tracking in milliseconds

Use cases​

  • Post pipeline status updates to a Slack channel
  • Create Stripe payment intents from workflow data
  • Send SMS alerts via Twilio when critical events occur
  • Create GitHub issues automatically from error detection pipelines
  • Call custom internal APIs as part of an integration workflow

Runtime​

  • Performance tier: variable

Input ports​

NameTypeRequiredDescription
paramsjsonNoAction parameters as key-value pairs
metadatajsonNoAdditional metadata for the request

Output ports​

NameTypeRequiredDescription
resultjsonNoFull integration response with service, action, data, status_code, and any errors
successbooleanNoWhether the integration call succeeded

Settings​

Basic​

SettingNameTypeRequiredDefaultAllowed valuesDescription
ServiceserviceenumYesslack, stripe, twilio, sendgrid, github, customThird-party service to integrate with
ActionactionstringYesService action to perform (e.g., post_message, send_email)

Auth​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Slack Tokenslack_tokensecretNoSlack Bot OAuth token
Stripe API Keystripe_api_keysecretNoStripe secret API key
Twilio Account SIDtwilio_account_sidsecretNoTwilio account SID
Twilio Auth Tokentwilio_auth_tokensecretNoTwilio auth token
SendGrid API Keysendgrid_api_keysecretNoSendGrid API key
GitHub Tokengithub_tokensecretNoGitHub personal access token

Advanced​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Timeout (seconds)timeoutnumberNo30min 1; max 300Request timeout in seconds
Custom URLurlstringNoURL for custom integration
Custom MethodmethodenumNoPOSTGET, POST, PUT, PATCH, DELETEHTTP method for custom integration
Custom HeadersheadersjsonNoCustom HTTP headers for custom integration

Errors​

CodeDescription
MISSING_SERVICEService name is required but was not provided
MISSING_ACTIONAction is required but was not provided
UNSUPPORTED_SERVICEService is not one of: slack, stripe, twilio, sendgrid, github, custom
UNSUPPORTED_ACTIONThe specified action is not supported for the selected service
MISSING_AUTH_TOKENRequired authentication token/key for the service was not provided

Runtime notes​

  • success is true only when HTTP status is 2xx — check result.status_code for specific codes
  • result.data contains the parsed JSON response body; non-JSON responses appear under result.raw_data
  • Each service requires its own auth token in the config auth group — missing tokens fail at execution
  • For custom service, provide url and method in config; params become the JSON request body

See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.

Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..