Description

n8n-nodes-pikarama

This is an n8n community node for Pikarama — a fair group decision-making app with karma-weighted voting.

n8n is a fair-code licensed workflow automation platform.

!Node Search

Installation

Follow the installation guide in the n8n community nodes documentation.

npm package name: n8n-nodes-pikarama

Credentials

To use this node, you need a Pikarama API token:

1. Log in to Pikarama
2. Go to Settings (gear icon)
3. Under API Tokens, click Generate New Token
4. Copy the token (starts with pk_)
5. In n8n, create new credentials:
– API Token: paste your pk_ token
– Base URL: https://www.pikarama.com

!Credentials Setup

Operations

Event

| Operation | Description |
|———–|————-|
| Create | Create a new event or poll. Select group, topic, participants, optional event description, and optionally create as poll with predefined options and option descriptions. |
| Get | Get details of a specific event |
| Get Many | List events with status filters |
| Submit | Submit one or more picks to an event (up to 3), with optional per-pick descriptions |
| Vote | Cast votes on submissions |
| Advance | Advance event to next phase |
| Cancel | Cancel an event |

Group

| Operation | Description |
|———–|————-|
| Get | Get group details |
| Get Many | List all your groups |
| Get Topics | List topics in a group |
| Get Members | List members of a group |

Karma

| Operation | Description |
|———–|————-|
| Get | Get karma statistics, optionally filtered by group |

User

| Operation | Description |
|———–|————-|
| Get Current | Get info about the authenticated user (verify API token ownership) |

Pikarama Trigger

The Pikarama Trigger node lets you receive real-time webhook events from Pikarama. When you activate a workflow, it automatically registers a webhook with Pikarama. When deactivated, it removes the webhook.

Events

| Event | Description |
|——-|————-|
| Event Created | Fires when a new event or poll is created |
| Event Closed | Fires when an event is completed (winner chosen) |
| Event Cancelled | Fires when an event is cancelled |
| Vote Cast | Fires when someone votes |
| Submission Added | Fires when someone submits a pick |

Filter by Groups

Optionally filter events to specific groups:

1. Enable Filter by Groups
2. Select one or more groups from the dropdown
3. Only events from those groups will trigger the workflow

Leave empty to receive events from all your groups.

Webhook Signature Verification

All webhook payloads are signed with HMAC-SHA256. The trigger node automatically verifies the X-Pikarama-Signature header to ensure payloads are authentic.

Recurring Event Fields

When an event is created by a recurring schedule (Plus/Pro plans), the payload includes additional fields:

{
  "event": "event.created",
  "data": {
    "event": {
      "id": "abc123",
      "name": "Friday Movie Night",
      "status": "submitting",
      "is_recurring": true,
      "schedule_id": "sch-456",
      "recurrence_rrule": "FREQ=WEEKLY;BYDAY=FR",
      "recurrence_dtstart": "2026-01-02T18:00:00Z",
      "recurrencetimezone": "America/NewYork",
      "event_time": "2026-03-07T18:00:00Z",
      "submission_deadline": "2026-03-07T17:00:00Z",
      "voting_deadline": "2026-03-07T18:00:00Z"
    }
  }
}

Use isrecurring to detect scheduled events vs manually created ones. The recurrencerrule field follows the RFC 5545 RRULE format.

Example: Create Calendar Event from Recurring Pikarama Event

1. Pikarama Trigger → Events: “Event Created”
2. IF Node → Condition: {{ $json.data.event.is_recurring }} equals true
3. Google Calendar Node:
– Summary: {{ $json.data.event.name }}
– Start: {{ $json.data.event.event_time }}
– Description: “Pikarama decision time! Submit your picks.”

Example: Notify Slack When Event Completes

1. Pikarama Trigger → Events: “Event Closed”
2. Slack Node → Send message: “🎉 Winner: {{ $json.data.winner.title }}”

Features

Dynamic Dropdowns

All selectors load data dynamically from your Pikarama account:

• Groups — Your groups
• Topics — Topics within selected group
• Events — Active events with status indicator
• Participants — Group members for event creation
• Submissions — Available picks for voting

!Event Selector

Create Events with Participants

Select specific participants or leave empty to include all group members:

!Create Event

Poll Creation

Create polls with predefined options — no karma changes, just simple voting. You can add a short event description and optional descriptions for each poll option.

!Create Poll

Multi-Submit Support

Submit multiple picks at once (up to 3 per event). Add optional descriptions when the title alone needs context.

Example: Create a Weekly Lunch Poll

1. Schedule Trigger → Every Monday at 9 AM
2. Pikarama Node:
– Resource: Event
– Operation: Create
– Group: Select your team
– Topic: Select “Lunch” topic
– Event Name: “Friday Lunch Spot?”
– Is Poll: ✅
– Event Description: “Something nearby and quick enough for lunch break”
– Poll Options: “Pizza”, “Sushi”, “Thai”, “Burgers”
– Poll Option Descriptions: “Fast and cheap”, “Quieter but farther”, “Good vegetarian choices”, “Best for picky eaters”

Compatibility

• Tested with n8n version 2.9.x
• Requires Pikarama API v1

Resources

• Pikarama Website
• Pikarama API Documentation
• n8n Community Nodes Documentation

License

MIT