Connecting Attio and mapping Person data attributes

Connecting Attio takes about two minutes via OAuth. Once connected, configure your field mappings so enriched contact data lands in the right Attio person attributes when new people are created.

Written By Kevin Lawrie

Last updated About 6 hours ago

Connecting Attio

  1. Go to Integrations in the left sidebar.

  2. Find Attio and click Configure.

  3. Click Connect to Attio.

  4. You'll be redirected to Attio's OAuth authorisation screen.

  5. Review the requested permissions and click Authorise.

  6. You'll be redirected back automatically. The status shows Connected.

Once connected, the integration page shows three tabs: Authentication, Field Mapping, and Social Sync.

Field mapping

Field mapping controls which enriched contact data fields get written to which Attio person attributes when a new person is created — either from Signal Sync or from a sync rule.

Go to the Field Mapping tab after connecting.

How it works

The left side shows enriched contact fields from the platform (65+ fields across personal, company, education, funding, and location data). The right side shows your Attio person attributes. You map them by selecting the matching Attio attribute for each field you want to sync.

Default mappings

The integration comes with sensible defaults already configured:

Enriched field Attio attribute

First Name

name

Last Name

name

Email

email_addresses

Job Title

job_title

Social Profile (LinkedIn URL)

linkedin

Full Location

primary_location

Mobile Phone

phone_numbers

Available field groups

Expand each group to map additional fields:

  • Contact Details

  • Company Information

  • Company Funding & Growth

  • Location

  • Education

  • Personal Information

  • Employment Details

  • Social & Professional

  • Custom Properties (from AI Agents)

Saving your mapping

Click Save Field Mappings in the sticky footer when done. The mapping applies to all new people created via this integration going forward.

Click Reset to restore the default mappings at any time.

What happens next

With Attio connected and field mapping configured, you're ready to set up each capability:

  • [Monitoring your people's social activity] — set up Engagement Sync

  • [Tracking job changes] — monitor people for role changes

  • [Capturing your audience into Attio] — set up Signal Sync

  • [Setting up LinkedIn matching and the Profile Finder] — required for Engagement Sync and Job Change Monitoring

💡 Tip: Configure field mapping before creating sync rules or enabling Signal Sync — the mapping applies at the point of person creation.

Disconnecting Attio

Go to the Authentication tab and click Disconnect Integration. This revokes OAuth access and clears stored credentials. Your existing Attio people and notes are not affected.