View as Markdown
Givebutter icon

Givebutter ACTION

Create Contact

Create a new contact/donor in Givebutter, returning the created contact with its assigned id. For an individual contact, provide firstName and lastName; the email value is submitted as the API primary_email field. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Givebutter account once, then configure and run Create Contact 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: "givebutter-create-contact",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    givebutter: { 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.

Create Contact inputs
Property Type Description
firstName First Name string
Contact's first name (max 255 chars). For an individual contact without email or phone, provide both first and last names. Maps to the API first_name field.
Optional
lastName Last Name string
Contact's last name (max 255 chars). Maps to the API last_name field.
Optional
email Email string
Contact's primary email address. Submitted to Givebutter as the primary_email field. Example: jane@example.com.
Optional
phone Phone string
Contact's primary phone number. Maps to the API primary_phone field. Example: +15555550100.
Optional
type Type string
Type of contact to create. For company, provide Company Name instead of first/last name.
Optional
companyName Company Name string
Company name (max 255 chars). Required when Type is company. Maps to the API company_name field.
Optional
tags Tags string[]
Optional list of tag strings to attach to the contact (max 64 tags). Example: ["vip", "newsletter"].
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
givebutter-create-contact
Version
0.0.2
App
Givebutter
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes