View as Markdown
Copper icon

Copper ACTION

Create or Update Person

Creates a new person or updates an existing one based on email address. See the documentation
  • Action
  • Writes data
  • Destructive
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Copper account once, then configure and run Create or Update 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: "copper-create-update-person",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    copper: { authProvisionId: "apn_xxxxxxx" },
    email: "Email",
    name: "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 or Update Person inputs
Property Type Description
email Email string
Email address of the person. If email already exists, the person will be updated
Required
name Name string
Name of the contact. Required if creating a new person.
Optional
streetAddress Street Address string
Street address of the person
Optional
city City string
City address of the person
Optional
state State string
State address of the person
Optional
postalCode Postal Code string
Postal code of the person
Optional
country Country string
Country of the person
Optional
phone Phone string
Phone number of the person
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
copper-create-update-person
Version
0.0.4
App
Copper
Authentication
OAuth
Read-only
No
Destructive
Yes
Open world
Yes