View as Markdown
Dex icon

Dex ACTION

Create or Update Contact

Adds a new contact or updates an existing one if the email address already exists in the Dex system. See the documentation
  • Action
  • Writes data
  • Destructive
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

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

Create or Update Contact inputs
Property Type Description
email Email string
The email of the contact
Required
firstName First Name string
The first name of the contact
Optional
lastName Last Name string
The last name of the contact
Optional
phoneNumber Phone Number string
The phone number of the contact
Optional
jobTitle Job Title string
Job title of the contact
Optional
description Description string
Description of the contact
Optional
education Education string
Education of the contact
Optional
imageUrl Image URL string
Image URL of the contact
Optional
linkedin LinkedIn string
LinkedIn URL of the contact
Optional
twitter Twitter string
Twitter URL of the contact
Optional
instagram Instagram string
Instagram URL of the contact
Optional
telegram Telegram string
Telegram URL of the contact
Optional
birthdayYear Birthday Year string
Birthday year of the contact
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
dex-create-update-contact
Version
0.0.3
App
Dex
Authentication
API key
Read-only
No
Destructive
Yes
Open world
Yes