stairoids

n8n community node for Stairoids platform integration

Package Information

Released: 6 mo ago
Downloads: 7 weekly / 84 monthly
Latest Version: 0.1.9
Author: Thomas Berrens

Available Nodes

Documentation generating…

Stairoids Add Activity icon
Stairoids Add Activity
Add an activity to an existing lead in Stairoids
Stairoids Trigger icon
Stairoids Trigger
Triggers when events occur in Stairoids

Documentation

n8n-nodes-stairoids

This is an n8n community node package that integrates with the Stairoids platform.

n8n is a fair-code licensed workflow automation platform.

Installation

Community Nodes (Recommended)

  1. Go to Settings > Community Nodes
  2. Select Install
  3. Enter n8n-nodes-stairoids in the npm Package Name field
  4. Accept the risks and click Install

Manual Installation

To install this node manually:

cd ~/.n8n
npm install n8n-nodes-stairoids

Then restart n8n.

Development Installation

For local development and testing:

cd n8n-nodes-stairoids
npm install
npm run build
npm link

cd ~/.n8n/custom
npm link n8n-nodes-stairoids

Or use the environment variable approach:

N8N_CUSTOM_EXTENSIONS="/path/to/n8n-nodes-stairoids" npx n8n

Nodes

Stairoids Trigger

Webhook-based trigger node that listens for events from Stairoids.

Available Events:

Event Description
Funnel Change Triggers when a company's funnel state changes
Score Change Triggers when a company's lead score changes
ICP Change Triggers when a company's ICP assignment changes
New Activity Triggers when a company has new engagement activities

Stairoids (Action)

Add activities to leads in Stairoids.

Fields:

Field Required Description
Display Name Yes The name of the activity (e.g., "Has raised a lot of funding")
LinkedIn URL No LinkedIn URL of the person or company (preferred)
Website URL No Website URL of the company (fallback if no LinkedIn URL)
Score No Points to assign (only used on first occurrence of this display name)

Provide at least a LinkedIn URL or Website URL to link the activity to a lead. If neither is provided, the activity is saved as standalone.

Authentication

This node uses OAuth2 (PKCE) authentication with the Stairoids API.

Setup Steps

  1. In n8n, create new Stairoids API credentials
    2Complete the OAuth2 authorization flow

API Endpoints

The node interacts with the following Stairoids API endpoints:

Operation Method Endpoint
Subscribe Webhook POST /integrations/webhook/n8n/hooks/{event}/subscribe
Unsubscribe Webhook DELETE /integrations/webhook/n8n/hooks/{subscriptionId}
Add Activity POST /integrations/webhook/n8n/actions/add_activity

Example Workflow

[Stairoids Trigger: Score Change]
           |
           v
   [IF: Score > 80]
           |
     +-----+-----+
     |           |
     v           v
[Slack:      [Stairoids:
 Notify]      Add Activity]
  1. Trigger on score change
  2. Check if lead score is above threshold
  3. Notify team on Slack
  4. Log a follow-up activity

Compatibility

  • n8n version: 1.0.0+
  • Node.js: 18+

Support

For support, contact sam@stairoids.com.

License

MIT

Discussion