View as Markdown
NationBuilder icon

NationBuilder ACTION

Search Person

Create a new person with the provided data. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's NationBuilder account once, then configure and run Search Person from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "nationbuilder-search-person",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    nationbuilder: { authProvisionId: "apn_xxxxxxx" },
    firstName: "First Name",
    lastName: "Last Name",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Search Person inputs
Property Type Description
firstName First Name string
The person's first name and middle names.
Optional
lastName Last Name string
The person's last name.
Optional
email Email string
Email address for this person.
Optional
city City string
City of the primary address of people to match.
Optional
state State string
State of the primary address of people tto match.
Optional
sex Sex string
This person's gender.
Optional
birthdate Birthdate string
date of birth of the people to match.
Optional
updatedSince Updated Since string
People updated since the given date.
Optional
withMobile With Mobile string
Only people with mobile phone numbers.
Optional
customValues Custom Values object
Match custom field values.
Optional
civicrmId Civicrm Id string
Civicrm id of the person to match.
Optional
countyFileId County File Id string
Count File Id of the person to match.
Optional
stateFileId State File Id string
State File id of the person to match.
Optional
datatrustId Datatrust Id string
Datatrust Id of the person to match.
Optional
dwId DW Id string
DW Id of the person to match.
Optional
mediaMarketId Media Market Id string
Media market Id of the person to match.
Optional
ngpId NGP Id string
NGP Id of the person to match.
Optional
pfStratId PF Strat Id string
PD Strat Id of the person to match.
Optional
vanId Van Id string
Van Id of the person to match.
Optional
salesforceId Salesforce Id string
Salesforce Id of the person to match.
Optional
rncId RNC Id string
RNC Id of the person to match.
Optional
rncRegid RNC Reg Id string
RNC Reg Id of the person to match.
Optional
externalId External Id string
External Id of the person to match.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
nationbuilder-search-person
Version
0.0.2
App
NationBuilder
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes