DOCS · V1 · ATTIO

What foyai writes to your Attio workspace.

Last updated 2026-05-19

Records Foyai creates

foyai_room records

One foyai_room record per Foyai room. Created at room create time, updated when room metadata changes (slug, status, engagement, last buyer view, MAP completion).

  • Linked to the source Deal and Company via a relationship attribute.
  • Soft-deleted (not destroyed) when a room is archived in Foyai.

Person records

Foyai upserts buyer-side Person records when a new stakeholder appears in a room (from email-gated entry, MAP task assignment, or e-sign). Linked to the room's Company. Existing Person records are matched by email and not duplicated.

Attributes Foyai writes on Deals

Attribute
What it stores
Update cadence
foyai_engagement_score
0–100 composite of buyer views, link clicks, doc reads, MAP completions, video plays
Debounced, event-driven (typically within 60s)
foyai_last_buyer_view
Timestamp of the most recent buyer-side view
On each room_view event
foyai_active_stakeholders
Distinct buyer-side stakeholders engaged in the last 30 days
Daily rollup + on stakeholder change
foyai_map_completion
% of mutual-action-plan tasks complete
On each MAP task state change
foyai_room_url
Link to the Foyai room view (seller-side)
On room create

Foyai never modifies attributes outside this namespace.

Notes Foyai writes

Foyai may post the following kinds of notes on the linked Deal record:

  • Room activity rollup — a periodic synthesized summary of buyer engagement and committee inference, throttled to at most one per room per 24h. Marked with a Foyai signature so the source is unambiguous.
  • Suggested room updates — when a new call note arrives and the room intelligence pass surfaces a meaningful update.
  • Buying committee inference — a periodic note listing the inferred buying committee (deferred in v1; available in-app only).

You can disable any of these from Settings → Attio writes.

Tasks Foyai writes

When a seller creates or updates a Mutual Action Plan task in Foyai, the corresponding Attio task is created or updated. Conflict resolution: last-write-wins with a 2-second tiebreak; echoes are skipped via content hash. A side table (mapTaskSyncs) tracks sync metadata so deletions are safe and round-trips don't loop.

What Foyai does not do

  • We do not delete Deal, Company, or Person records.
  • We do not change Deal stages or pipelines.
  • We do not modify your existing custom attributes.
  • We do not export your Attio data outside the Foyai application boundary.
  • We do not train third-party AI models on your data.

Related