View as Markdown
Freshmarketer icon

Freshmarketer ACTION

Add or Update Contact

Create a new contact or updates an existing one.
  • Action
  • Writes data
  • Destructive
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Freshmarketer account once, then configure and run Add or Update 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: "freshmarketer-add-update-contact",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    freshmarketer: { authProvisionId: "apn_xxxxxxx" },
    email: "Contact Email",
    firstName: "First 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.

Add or Update Contact inputs
Property Type Description
email Contact Email string
Email on which enttity needs to be created or updated.
Required
firstName First Name string
First name of the contact.
Optional
lastName Last Name string
Last name of the contact.
Optional
subscriptionStatus Subscription Status string
Status of subscription that the contact is in.
Optional
jobTitle Job Title string
Designation of the contact in the account he belongs to.
Optional
workNumber Work Number string
Work phone number of the contact.
Optional
externalId External Id string
External ID of the contact.
Optional
mobileNumber Mobile Number string
Mobile phone number of the contact.
Optional
address Address string
Address of the contact.
Optional
city City string
City that the contact belongs to.
Optional
state State string
State that the contact belongs to.
Optional
zipcode Zipcode string
Zipcode of the region that the contact belongs to.
Optional
country Country string
Country that the contact belongs to.
Optional
territoryId Territory ID string
ID of the territory that the contact belongs to.
Optional Dynamic
leadSourceId Lead Source ID string
ID of the source where contact came from.
Optional Dynamic
ownerId Owner ID string
ID of the user to whom the contact has been assigned.
Optional Dynamic

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
freshmarketer-add-update-contact
Version
0.1.0
App
Freshmarketer
Authentication
API key
Read-only
No
Destructive
Yes
Open world
Yes