attio: Create or Update Record – Appmixer connector library

Basic Information

Name

appmixer.attio.core.UpsertRecord

Label

Create or Update Record

Version

1.0.0

Visibility

Public

Description

Create a record, or update the existing one that has the same value of the matching attribute. Multiselect values are added to the existing ones.

Input Ports

in

Field	Type	Description
Object	text	Pick an object or type its API slug or ID, for example `people`, `companies` or `deals`.
Matching Attribute	text	API slug or ID of a unique attribute used to find an existing record, for example `email_addresses` for people or `domains` for companies.
Values	textarea	A JSON object mapping attribute API slugs to values, for example `{"name": "Acme Inc.", "domains": ["acme.com"]}`. Use List Attributes to see the slugs of an object. Plain values are accepted for most attribute types (text, number, email, domain, select option title, status title, checkbox). Multiselect attributes take an array. See attribute types. The values must include the matching attribute.

Output Ports

out

Field	Type	Description
Record ID	string	-
Object ID	string	-
Workspace ID	string	-
Created At	string	-
Web URL	string	-
Values	object	-
Raw Values	object	-

Full Metadata

#metadata-viewer { display: none; }{ "name": "appmixer.attio.core.UpsertRecord", "label": "Create or Update Record", "description": "Create a record, or update the existing one that has the same value of the matching attribute. Multiselect values are added to the existing ones.", "author": "Appmixer <info@appmixer.com>", "version": "1.0.0", "auth": { "service": "appmixer:attio" }, "quota": { "manager": "appmixer:attio", "resources": "requests", "scope": { "userId": "{{userId}}" } }, "inPorts": [ { "name": "in", "schema": { "type": "object", "properties": { "objectId": { "type": "string" }, "matchingAttribute": { "type": "string" }, "values": { "type": "string" } }, "required": [ "objectId", "matchingAttribute", "values" ] }, "inspector": { "inputs": { "objectId": { "type": "text", "label": "Object", "index": 1, "tooltip": "Pick an object or type its API slug or ID, for example <code>people</code>, <code>companies</code> or <code>deals</code>.", "source": { "url": "/component/appmixer/attio/core/ListObjects?outPort=out", "data": { "messages": { "in/outputType": "array" }, "properties": { "isSource": true }, "transform": "./ListObjects#toSelectArray" } } }, "matchingAttribute": { "type": "text", "label": "Matching Attribute", "index": 2, "tooltip": "API slug or ID of a unique attribute used to find an existing record, for example <code>email_addresses</code> for people or <code>domains</code> for companies.", "source": { "url": "/component/appmixer/attio/core/ListAttributes?outPort=out", "data": { "messages": { "in/outputType": "array", "in/objectId": "inputs/in/objectId" }, "properties": { "isSource": true }, "transform": "./ListAttributes#toUniqueSelectArray" } } }, "values": { "type": "textarea", "label": "Values", "index": 3, "tooltip": "A JSON object mapping attribute API slugs to values, for example <code>{\"name\": \"Acme Inc.\", \"domains\": [\"acme.com\"]}</code>. Use List Attributes to see the slugs of an object. Plain values are accepted for most attribute types (text, number, email, domain, select option title, status title, checkbox). Multiselect attributes take an array. See <a href=\"https://docs.attio.com/rest-api/attribute-types/attribute-types\" target=\"_blank\">attribute types</a>. The values must include the matching attribute." } } } } ], "outPorts": [ { "name": "out", "schema": { "type": "object", "properties": { "id": { "type": "string", "title": "Record ID", "example": "bf071e1f-6035-429d-b874-d83ea64ea13b" }, "objectId": { "type": "string", "title": "Object ID", "example": "97052eb9-e65e-443f-a297-f2d9a4a7f795" }, "workspaceId": { "type": "string", "title": "Workspace ID", "example": "14beef7a-99f7-4534-a87e-70b564330a4c" }, "createdAt": { "type": "string", "format": "date-time", "title": "Created At", "example": "2026-10-20T08:00:00.000000000Z" }, "webUrl": { "type": "string", "title": "Web URL", "example": "https://app.attio.com/acme/company/bf071e1f-6035-429d-b874-d83ea64ea13b" }, "values": { "type": "object", "title": "Values", "example": { "name": "Acme Inc.", "domains": "acme.com", "description": "Maker of fine widgets" } }, "rawValues": { "type": "object", "title": "Raw Values", "example": { "name": [ { "active_from": "2026-10-20T08:00:00.000000000Z", "active_until": null, "value": "Acme Inc." } ], "domains": [ { "active_from": "2026-10-20T08:00:00.000000000Z", "active_until": null, "value": "acme.com" } ], "description": [ { "active_from": "2026-10-20T08:00:00.000000000Z", "active_until": null, "value": "Maker of fine widgets" } ] } } } } } ], "icon": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI2NCIgaGVpZ2h0PSI2NCIgdmlld0JveD0iLTEuNSAtMyAzNCAzMiI+PHBhdGggZD0iTTMwLjY0NjggMTcuNzgyM0wyOC4wNTk5IDEzLjY0MjJDMjguMDU5OSAxMy42NDIyIDI4LjA1MDMgMTMuNjI0OCAyOC4wNDQ1IDEzLjYxNzJMMjcuODQwNSAxMy4yOTE5QzI3LjQ1NTUgMTIuNjc0IDI2Ljc4OTUgMTIuMzA0NSAyNi4wNjIgMTIuMzAyNUwyMS44OTQ5IDEyLjI4OTFMMjEuNjA0MiAxMi43NTQ5TDE2LjYyNDkgMjAuNzIzNEwxNi4zNDk2IDIxLjE2NDJMMTguNDM2MSAyNC40OTc4QzE4LjgyMSAyNS4xMTc2IDE5LjQ4NyAyNS40ODcyIDIwLjIyMDMgMjUuNDg3MkgyNi4wNkMyNi43Nzk5IDI1LjQ4NzIgMjcuNDYxMyAyNS4xMDggMjcuODQyNCAyNC40OTk4TDI4LjA0ODMgMjQuMTcwNkMyOC4wNDgzIDI0LjE3MDYgMjguMDU2IDI0LjE2MSAyOC4wNTggMjQuMTU3MkwzMC42NDg3IDIwLjAxMTJDMzEuMDc0MSAxOS4zMzM3IDMxLjA3NDEgMTguNDU3OSAzMC42NDg3IDE3Ljc4MjNIMzAuNjQ2OFpNMjkuODU3NiAxOS41MTY2TDI3LjI2NjkgMjMuNjYyNUMyNy4yNTUzIDIzLjY4MTcgMjcuMjQxOSAyMy42OTcxIDI3LjIzMDMgMjMuNzEyNUMyNy4xMzk4IDIzLjgxNDYgMjcuMDIyNCAyMy44MjggMjYuOTcwNSAyMy44MjhDMjYuOTEwOCAyMy44MjggMjYuNzY0NSAyMy44MTA3IDI2LjY3MDIgMjMuNjYwNkwyNC4wNzk1IDE5LjUxNDZDMjQuMDUwNiAxOS40Njg0IDI0LjAyNTYgMTkuNDIwMyAyNC4wMDI1IDE5LjM2ODNDMjMuOTc5NCAxOS4zMTgzIDIzLjk2MjEgMTkuMjY4MyAyMy45NDY3IDE5LjIxNjNDMjMuODg4OSAxOS4wMDg0IDIzLjg4ODkgMTguNzg1MSAyMy45NDY3IDE4LjU3NzNDMjMuOTc1NSAxOC40NzUzIDI0LjAxOTggMTguMzczMiAyNC4wNzc1IDE4LjI4MDlMMjYuNjY0NCAxNC4xMzg4QzI2LjY2NDQgMTQuMTM4OCAyNi42NjgzIDE0LjEzMyAyNi42NzAyIDE0LjEyOTFDMjYuNzMxOCAxNC4wMzY3IDI2LjgwODggMTMuOTk0NCAyNi44NzYyIDEzLjk4MDlDMjYuOTAzMSAxMy45NzMyIDI2LjkyNjIgMTMuOTcxMyAyNi45NDU0IDEzLjk2NzVDMjYuOTU1MSAxMy45Njc1IDI2Ljk2NDcgMTMuOTY3NSAyNi45NzQzIDEzLjk2NzVDMjcuMDM0IDEzLjk2NzUgMjcuMTgyMiAxMy45ODY3IDI3LjI3NDYgMTQuMTM2OEwyOS44NjE1IDE4LjI3N0MzMC4wOTgyIDE4LjY1NDMgMzAuMDk4MiAxOS4xMzkzIDI5Ljg2MTUgMTkuNTE2NkgyOS44NTc2WiIgZmlsbD0iIzAwMDAwMCIvPjxwYXRoIGQ9Ik0yMi45OTEzIDcuNzY0NEMyMy40MTQ4IDcuMDg0OTYgMjMuNDE0OCA2LjIxMTEyIDIyLjk5MTMgNS41MzU1M0wyMC40MDQ0IDEuMzk1MzZMMjAuMTg4OSAxLjA0Njk3QzE5LjgwMiAwLjQyOTEyNSAxOS4xMzYgMC4wNTk1NzAzIDE4LjQwNDYgMC4wNTk1NzAzSDEyLjU2NDlDMTEuODM1NCAwLjA1OTU3MDMgMTEuMTY5NCAwLjQyOTEyNSAxMC43ODA2IDEuMDQ4OUwwLjMyMzM2MSAxNy43ODQ3QzAuMTEzNTYxIDE4LjExOTYgMCAxOC41MDY1IDAgMTguODk5MkMwIDE5LjI5MTggMC4xMTE2MzYgMTkuNjc4NyAwLjMyMTQzNiAyMC4wMTE3TDMuMTI1ODIgMjQuNTAyMkMzLjUxMjcgMjUuMTIxOSA0LjE3ODY2IDI1LjQ4OTYgNC45MDgxNSAyNS40ODk2SDEwLjc0NzlDMTEuNDgxMiAyNS40ODk2IDEyLjE0NzIgMjUuMTIgMTIuNTMyMSAyNC41MDAyTDEyLjc0NTggMjQuMTYxNUMxMi43NDU4IDI0LjE2MTUgMTIuNzQ1OCAyNC4xNjE1IDEyLjc0NTggMjQuMTU3NkMxMi43NDU4IDI0LjE1NzYgMTIuNzQ5NiAyNC4xNTE5IDEyLjc0OTYgMjQuMTQ5OUwxNC44MzQyIDIwLjgxNjJMMjEuMDEyNyAxMC45Mjg3TDIyLjk4NzUgNy43NjYzM0wyMi45OTEzIDcuNzY0NFpNMjIuMzgxMiA2LjY0OTk2QzIyLjM4MTIgNi44NjM2MSAyMi4zMjE1IDcuMDc5MTkgMjIuMjAwMiA3LjI2OTc0TDExLjk1NjYgMjMuNjY0OUMxMS44NjQzIDIzLjgxMzEgMTEuNzE2IDIzLjgzMDQgMTEuNjU2NCAyMy44MzA0QzExLjU5NjcgMjMuODMwNCAxMS40NTA0IDIzLjgxMzEgMTEuMzU2MSAyMy42NjQ5TDguNzY3MyAxOS41MTdDOC41MzI0OCAxOS4xNDE3IDguNTMyNDggMTguNjU4NiA4Ljc2NzMgMTguMjc5NEwxOS4wMTA5IDEuODg4MUMxOS4xMDMzIDEuNzM3OTcgMTkuMjUxNSAxLjcyMDY0IDE5LjMxMTIgMS43MjA2NEMxOS4zNzA4IDEuNzIwNjQgMTkuNTE5IDEuNzM3OTcgMTkuNjEzNCAxLjg5MDAyTDIyLjIwMDIgNi4wMzAxOUMyMi4zMjE1IDYuMjIwNzQgMjIuMzgxMiA2LjQzNjMyIDIyLjM4MTIgNi42NDk5NlY2LjY0OTk2WiIgZmlsbD0iIzAwMDAwMCIvPjwvc3ZnPg==" }