---
title: "n8n integration guide"
description: "Connect AgendaForge to n8n with the community node (triggers + actions) or the generic HTTP Request node."
canonical: "https://agendaforge.app/docs/n8n"
last-updated: 2026-08-22
---
# n8n integration guide
> Connect AgendaForge to n8n with the community node (triggers + actions) or the generic HTTP Request node.
Canonical page: https://agendaforge.app/docs/n8n
Last reviewed or updated: 2026-08-22
Content type: page

Last updated: August 22, 2026
Breadcrumb: Home > Developers > n8n guide

Automate event workflows with n8n: react the moment something changes in AgendaForge with instant triggers, and write records back with Create actions. Two ways to connect, both using the same API key and endpoints:

A. AgendaForge community node (recommended): install the npm package n8n-nodes-agendaforge (Settings > Community Nodes > Install on self-hosted n8n; it appears in the node panel on n8n Cloud once verified). Create an AgendaForge API credential with your afk_live_ key (validated against GET /me). The AgendaForge node offers Create for Contact, Session, and Sponsor (records are stamped source: "n8n"). The AgendaForge Trigger node auto-subscribes its webhook when the workflow is activated and unsubscribes on deactivation; no manual URL copying.

B. Generic HTTP Request node (no install): call the REST API directly with a Bearer header. Covers actions only (POST /contacts, POST /sessions, POST /sponsors). For triggers without the node, subscribe manually with POST /hooks?source=n8n and a body of { "event": "contact.added", "targetUrl": "..." }, and unsubscribe with DELETE /hooks/:id.

Generating a key: Event Settings > Integrations > n8n > Generate key. Shown once; Owner or Admin only; revocable from the same panel. Keys are organization-wide and shared with Zapier and Make.com. Base URL: https://api.agendaforge.app/api/v1.

Trigger events: contact, session, and sponsor added / updated / removed, plus speaker confirmed / declined, submission created / status changed, review completed, and event published. Each delivery POSTs an envelope of the form { "event": "contact.added", "timestamp": "ISO-8601", "payload": { ...the resource... } }, so map payload.* rather than the top level. Deliveries retry up to 3 times; re-subscribing the same URL and event is a no-op. Each delivery carries X-Webhook-Signature (HMAC-SHA256 of the raw body keyed with the endpoint secret); the page includes a Code-node snippet for verifying it. Sessions and sponsors need an eventId from the same organization as the key; a record created via an action also fires the matching "added" trigger.

---

AgendaForge is an AI-native event-management platform. Public machine-readable index: https://agendaforge.app/api/ai