All tools
AttioA

by Attio

Create a record

Creates a person, company, deal or custom-object record, and fails if a unique attribute such as a domain or email address is already taken.

View on GitHub
Updated Sep 27, 2026Available asMCPAPI

Description

To update the existing record instead of failing on a conflict, upsert it.

create-record.md

Create a record

Creates a person, company, deal or custom-object record, and fails if a unique attribute such as a domain or email address is already taken.

To update the existing record instead of failing on a conflict, upsert it.

Set up

Use the first option your agent supports.

MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

{ "mcpServers": { "attio": { "url": "https://mcp.attio.com/mcp" } } }

Call the MCP tool create-record.

Server URL: https://mcp.attio.com/mcp

API (official)

Before doing anything else, make one read-only call to confirm access.

Rules

  • Ask the user before anything that sends messages, costs money, or changes data.
  • Never print API keys.

Built from these files in the repository

The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.

Ways in

RouteSourceCallRequiredDocs
MCPOfficial · remotecreate-recordOAuthDocs
APIOfficialPOST /v2/objects/{object}/recordsAPI key in $ATTIO_API_KEYDocs

Workflows using Create a record