n8n-nodes-groundhogg

An n8n community node for the Groundhogg CRM REST API (v4).

Groundhogg is a WordPress-based marketing-automation / CRM plugin. This node lets your n8n workflows read and write contacts, tags, notes, tasks and activity from a Groundhogg install.

Installation

In n8n:

1. Go to Settings → Community Nodes.
2. Click Install.
3. Enter the package name: n8n-nodes-groundhogg
4. Agree to the risks and install.

Or install manually:

npm install n8n-nodes-groundhogg

Credentials

Create a credential of type Groundhogg API with:

Field	Value
Site URL	Your WordPress site URL, e.g. https://example.com
Public Key	From Groundhogg → Settings → API Keys
Secret Key	From Groundhogg → Settings → API Keys

The node signs requests using the Gh-Public-Key + Gh-Token headers. Gh-Token is computed as md5(secretKey + publicKey) — never exposing the secret on the wire.

Requires Groundhogg 3.x+ (REST API v4).

Supported resources

Contact

• Create, Get, Get Many, Update, Delete
• Create/Update support core fields (name, optin status, owner), meta fields (phone, address, company, birthday, lead source, notes), tag application/removal, and Groundhogg custom fields via n8n's Resource Mapper.
• Create is an upsert — if a contact with the email already exists it is updated.

Contact Tag

• Apply Tags, Remove Tags, Get Tags
• Accepts comma-separated tag IDs or tag names. Unknown tag names on Apply are auto-created by Groundhogg.

Tag

• Create, Get, Get Many, Update, Delete

Note

• Create, Get, Get Many, Update, Delete
• Notes are attached to a contact via the Contact ID field.

Task

• Create, Get, Get Many, Update, Delete
• Complete and Incomplete — toggle a task's completion state.

Activity

• Get Many — read engagement events (opens, clicks, page views, form submissions, bounces, etc.) optionally filtered by contact ID and activity type.

Development

# install
npm install

# build (compiles TS + copies icons/JSON into dist/)
npm run build

# live rebuild during development
npm run dev

Local testing against n8n

The easiest path is to link the built package into your local n8n:

# from this repo
npm run build
npm link

# in your n8n custom-nodes directory
# (typically ~/.n8n/custom on Linux/macOS; %USERPROFILE%\.n8n\custom on Windows)
npm link n8n-nodes-groundhogg

Then restart n8n and the Groundhogg node should appear in the node picker.

Endpoints reference

All endpoints are under <site>/wp-json/gh/v4/.

Node operation	HTTP	Path
Contact: Create	POST	/contacts
Contact: Get	GET	/contacts/{id}
Contact: Get Many	GET	/contacts
Contact: Update	PUT	/contacts/{id}
Contact: Delete	DELETE	/contacts/{id}
Contact Tag: Apply	POST	/contacts/{id}/tags
Contact Tag: Remove	DELETE	/contacts/{id}/tags
Contact Tag: Get	GET	/contacts/{id}/tags
Tag: Create	POST	/tags
Tag: Get	GET	/tags/{id}
Tag: Get Many	GET	/tags
Tag: Update	PUT	/tags/{id}
Tag: Delete	DELETE	/tags/{id}
Note: Create	POST	/notes
Note: Get	GET	/notes/{id}
Note: Get Many	GET	/notes
Note: Update	PUT	/notes/{id}
Note: Delete	DELETE	/notes/{id}
Task: Create	POST	/tasks
Task: Get	GET	/tasks/{id}
Task: Get Many	GET	/tasks
Task: Update	PUT	/tasks/{id}
Task: Delete	DELETE	/tasks/{id}
Task: Complete	PUT	/tasks/{id}/complete
Task: Incomplete	PUT	/tasks/{id}/incomplete
Activity: Get Many	GET	/activity

License

MIT