View as Markdown
Attio icon

Attio ACTION

Create or Update Record

Creates or updates a specific record such as a person or a company. If a record with the same matching attribute already exists, it's updated; otherwise a new record is created. Objects without a unique attribute to match on (e.g. deals) are not available here. Example: Object companies, Matching Attribute domains, Values { "domains": ["acme.com"], "name": "Acme" }. Returns the created or updated record with its id. See the documentation
  • Action
  • Writes data
  • Destructive
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Attio account once, then configure and run Create or Update Record 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: "attio-create-update-record",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    attio: { authProvisionId: "apn_xxxxxxx" },
    objectId: "Object ID",
    matchingAttribute: "Matching Attribute",
  },
})

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 Record inputs
Property Type Description
objectId Object ID string
The identifier of an object
Required Dynamic
matchingAttribute Matching Attribute string
The ID or slug of the attribute to use to check if a record already exists. The attribute must be unique.
Required Dynamic
values Values object
Attribute slug to value pairs for the record, e.g. { "name": "Ada Lovelace", "email_addresses": ["ada@example.test"] }. Include the matching attribute among them. See the attributes endpoint for what a given object accepts.
Required

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
attio-create-update-record
Version
0.1.1
App
Attio
Authentication
OAuth
Read-only
No
Destructive
Yes
Open world
Yes