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
| Name | Type | Required | Description |
|---|---|---|---|
params | json | No | Action parameters as key-value pairs |
metadata | json | No | Additional metadata for the request |
Output ports
| Name | Type | Required | Description |
|---|---|---|---|
result | json | No | Full integration response with service, action, data, status_code, and any errors |
success | boolean | No | Whether the integration call succeeded |
Settings
Basic
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Service | service | enum | Yes | slack, stripe, twilio, sendgrid, github, custom | Third-party service to integrate with | |
| Action | action | string | Yes | Service action to perform (e.g., post_message, send_email) |
Auth
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Slack Token | slack_token | secret | No | Slack Bot OAuth token | ||
| Stripe API Key | stripe_api_key | secret | No | Stripe secret API key | ||
| Twilio Account SID | twilio_account_sid | secret | No | Twilio account SID | ||
| Twilio Auth Token | twilio_auth_token | secret | No | Twilio auth token | ||
| SendGrid API Key | sendgrid_api_key | secret | No | SendGrid API key | ||
| GitHub Token | github_token | secret | No | GitHub personal access token |
Advanced
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Timeout (seconds) | timeout | number | No | 30 | min 1; max 300 | Request timeout in seconds |
| Custom URL | url | string | No | URL for custom integration | ||
| Custom Method | method | enum | No | POST | GET, POST, PUT, PATCH, DELETE | HTTP method for custom integration |
| Custom Headers | headers | json | No | Custom HTTP headers for custom integration |
Errors
| Code | Description |
|---|---|
MISSING_SERVICE | Service name is required but was not provided |
MISSING_ACTION | Action is required but was not provided |
UNSUPPORTED_SERVICE | Service is not one of: slack, stripe, twilio, sendgrid, github, custom |
UNSUPPORTED_ACTION | The specified action is not supported for the selected service |
MISSING_AUTH_TOKEN | Required 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.
Something unclear? Send documentation feedback by email.