agam-crm

n8n community node for Agam CRM integration — WhatsApp groups, contacts, donations, enrichment, RSVP, volunteers

Package Information

Downloads: 0 weekly / 0 monthly
Latest Version: 0.3.4
Author: ytrofr

Documentation

n8n-nodes-agam-crm

Custom n8n community node for integrating with Agam CRM — a WordPress plugin managing contacts, WhatsApp groups, donations, enrichment data, RSVPs, and volunteers.

Compatible with Agam CRM WordPress plugin v1.2.7.


Resources and Operations

Resource Operation Method Endpoint
Contact Get Info GET /contacts/contact-info
Contact Get Activities GET /contacts/contact-activities
WhatsApp Group Log Activity POST /beacon/wa-groups
WhatsApp Group Get Activities GET /beacon/wa-groups
Donation Create POST /donations/payment
Donation Get Many GET /donations/payment
Enrichment Create POST /agam/enrichment
Enrichment Get Many GET /agam/enrichment
Event Get Info GET /forms/events/info
RSVP Confirm POST /forms/events/rsvp
Volunteer Get GET /forms/volunteers

All endpoints are relative to the base URL configured in the credentials (e.g. https://your-site.com/api/agamcrm/v1).


Installation

In your n8n instance, go to Settings > Community Nodes > Install and enter:

n8n-nodes-agam-crm

Or install via npm if you are running n8n self-hosted:

npm install n8n-nodes-agam-crm

Credentials

Create an Agam CRM API credential with two fields:

Field Description Example
Base URL Full URL to the WordPress REST API endpoint https://your-site.com/api/agamcrm/v1
REST API Key General REST API Key from Agam CRM Settings (sent as Bearer token) abc123...

The key is sent as Authorization: Bearer <key> on every request.


Resource Reference

Contact

Both operations require Phone Number (with country code, e.g. +972501234567).

Get Info — returns the contact record matching the phone number.

Get Activities — returns activity history. Optional filters:

Field Type Description
From Date string Start date Y-m-d
Until Date string End date Y-m-d

WhatsApp Group

Log Activity — records a group event. Required fields:

Field Description
Created At Activity timestamp (ISO 8601). Defaults to $now.
Beacon ID Contact's Beacon ID
Phone Number Contact's phone number (with country code)
WhatsApp User ID WhatsApp user ID
Group Name Name of the WhatsApp group
Activity One of: joined, left, removed, reacted, replied, voted, posted

Optional additional fields: First Name, Last Name, Nickname.

Get Activities — queries activity records. Optional filters: From Date, Until Date, Phone Number, Beacon ID, Group Name, Activity.


Donation

Create — records a payment. Required field: Asmachta (payment reference number).

Optional fields include: Sum, Full Name, Payer Phone, Payer Email, Payment Date (Y-m-d or Y-m-d H:i:s), Description, Card Suffix, Card Type, Card Brand, Payments Number, Status, Transaction ID, Card Type Code, Card Brand Code, Card Expiration, First Payment Sum, Periodical Payment Sum, Status Code, Transaction Type ID, Payment Type, All Payments Number, Transaction Token, Payment Link Process ID, Payment Link Process Token, Invoice License Number, Invoice Name, Address.

Get Many — queries donation records. Optional filters: Asmachta, From Date, Until Date, Payer Email, Payer Phone.


Enrichment

Create — stores contact enrichment data. Required field: Phone (with country code).

Optional fields: Created At, Israeli ID, Nickname, First Name, Last Name, Email, Birth Year, Settlement, Political Affiliation (liberal / indecisive / conservative), Reservist (boolean), Likud Member (boolean).

Get Many — queries enrichment records. Optional filters: From Date, Until Date, Email, Phone.


Event

Get Info — retrieves all available event forms. No input fields required.


RSVP

Confirm — confirms or declines a registration for an event. Required fields:

Field Description
Phone Number Phone used during event registration
RSVP Response yes or no

Event Identifier (provide at least one):

Field Description
Event Slug The event slug identifier
Event Post ID The WordPress post ID of the event

Volunteer

Get — retrieves volunteer records filtered by interest area.

Interests (multi-select, leave empty to return all):
logistics, kalpi_committee, kalpi_booth, parlor_meeting, local_activists, content, social


Architecture

Beacon (WhatsApp platform) → n8n Trigger → Agam CRM Node → WordPress REST API → MySQL DB

The phone number is the bridge between Beacon and Agam CRM. Both systems use the mobile number as the unified contact identifier.


Changelog

v0.3.1 — 2026-03-10

Matches Agam CRM WordPress plugin v1.2.7.

Added

  • Contact resource: getInfo and getActivities operations (lookup by phone number)
  • Event resource: getInfo operation for event forms

Changed

  • WhatsApp Group: URL updated to plural /beacon/wa-groups for both POST and GET; three new required fields added — createdAt, phoneNumber, whatsappUserId; GET now uses query params instead of path param
  • RSVP: method changed from PATCH to POST; eventId path param replaced by body fields eventSlug / eventPostId
  • Enrichment: field names updated to camelCase (israeliId, firstName, lastName, birthYear, politicalAffiliationAgam, likudMember)
  • Donation: 15 new optional fields added (card details, payment links, invoice fields)
  • Volunteer: interest (singular string) replaced by interests (plural multi-select array); empty selection returns all volunteers

Removed

  • Beacon Contact resource (all 4 operations) — disabled in WP plugin v1.2.7
  • Tag resource (both operations) — disabled in WP plugin v1.2.7

v0.2.0

Initial published release with Beacon Contact, Tag, WhatsApp Group, Donation, Enrichment, RSVP, and Volunteer resources.


License

MIT

Discussion