@c3toronto/n8n-nodes-pco

This is an n8n community node that lets you use Planning Center Online (People API) in your n8n workflows.

Planning Center People helps you manage contact data, membership info, and everything you need to know about your people with confidence.

n8n is a fair-code licensed workflow automation platform.

Table of Contents

• Installation
• Prerequisites
• Operations
• Credentials
• Compatibility
• Usage
• Development
• Resources
• License

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Node Installation

1. Go to Settings > Community Nodes in your n8n instance
2. Click Install
3. Enter @c3toronto/n8n-nodes-pco in the npm Package Name field
4. Agree to the risks and click Install

After installation, the Planning Center People node will appear in your nodes panel.

Manual Installation (Self-Hosted)

cd ~/.n8n
npm install @c3toronto/n8n-nodes-pco

Then restart your n8n instance.

Prerequisites

You need the following:

1. n8n installation (self-hosted or cloud)
2. A Planning Center Online account
3. Planning Center API credentials (Personal Access Token)

Operations

This node provides access to the Planning Center People API v2, including operations for:

• People - Manage person records and profiles
• Lists - Create and manage dynamic lists of people
• Forms - Access form submissions and responses
• Households - Manage household relationships
• Campuses - Access campus information
• Field Definitions - Work with custom fields
• Notes - Add and retrieve notes on person profiles
• Addresses - Manage contact addresses
• Phone Numbers - Manage contact phone numbers
• Emails - Manage contact email addresses
• Workflows - Access workflow data
• Messages - View message history
• And many more...

Each operation supports filtering, pagination, and additional parameters through the "Additional Fields" option.

Credentials

To connect to Planning Center Online, you'll need to create a Personal Access Token:

1. Log in to your Planning Center account
2. Go to your Personal Access Tokens page
3. Click New Personal Access Token
4. Give it a name (e.g., "n8n Integration")
5. Copy the Application ID and Secret

In n8n, create a new "People API" credential with:

• URL: https://api.planningcenteronline.com/people/v2 (default)
• Client ID: Your Application ID
• Client Secret: Your Secret

Compatibility

• Tested with n8n version: 1.120.4+
• Planning Center People API: v2
• Node version: 18.10 or higher

Usage

Example 1: Get All People

1. Add the Planning Center People node
2. Select Resource: Person
3. Select Operation: GET /people
4. Configure any filters in Additional Fields (optional)
5. Execute the workflow

Example 2: Get Form Submissions

1. Add the Planning Center People node
2. Select Resource: Form
3. Select Operation: GET /forms/{form_id}/form_submissions
4. Enter the Form Id
5. Add filters in Additional Fields if needed (e.g., date ranges)
6. Execute the workflow

Example 3: Update a Person's Information

1. Add the Planning Center People node
2. Select Resource: Person
3. Select Operation: PATCH /people/{person_id}
4. Enter the Person Id
5. Configure the fields to update in Additional Fields
6. Execute the workflow

Tips

• Required fields appear at the top level (e.g., form_id, person_id)
• Optional fields are grouped under "Additional Fields" to keep the interface clean
• Use the filter and where parameters to narrow down results
• Check the Planning Center API Documentation for field details

Development

Setup

# Clone the repository
git clone https://github.com/c3toronto/n8n-nodes-pco.git
cd n8n-nodes-pco

# Install dependencies
npm install

# Build the project
npm run build

Local Testing

# Link the package locally
npm link

# In your n8n installation directory
cd ~/.n8n/custom
npm link @c3toronto/n8n-nodes-pco

# Start n8n
n8n start

Development Commands

# Build
npm run build

# Watch mode (rebuild on changes)
npm run dev

# Run tests
npm run test

# Lint
npm run lint

# Format code
npm run format

Project Structure

n8n-nodes-pco/
├── credentials/
│   └── peopleApi.credentials.ts    # API authentication
├── nodes/
│   └── pco/
│       ├── people.node.ts          # Main node implementation
│       ├── people.node.json        # Node metadata
│       ├── openapi_people.json     # OpenAPI specification
│       └── logo.png                # Node icon
└── dist/                           # Compiled output

Resources

• n8n community nodes documentation
• Planning Center API Documentation
• Planning Center People API Reference

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Version History

See CHANGELOG.md for details.

License

MIT

Credits

This node was built using @devlikeapro/n8n-openapi-node, which generates n8n nodes from OpenAPI specifications.

Built with ❤️ by C3 Toronto

Note: This is a community-maintained package and is not officially associated with Planning Center or n8n.io.