Newfoyai now builds each buyer their own deck from your Google Slides template.A deck for every buyer.

See how it worksSee how
DOCS · V1 · ATTIO

What foyai writes to your Attio workspace.

Last updated 2026-10-01

Records Foyai creates

foyai_room records

One foyai_room record per foyai room, in a custom object foyai creates when you connect Attio. Created when the room is created, and updated as the room changes.

Attribute
What it stores
name
The room's name
room_url
The buyer link to the room
room_edit_url
The link to edit the room in foyai (your team only)
analytics_url
The link to the room's analytics in foyai
status
draft, active or archived
engagement_score
0–100, same formula as the Deal attribute below
last_buyer_view
Timestamp of the most recent buyer visit
block_count
Number of content blocks in the room
stakeholder_count
Number of stakeholders on the room
linked_deal
Relationship to the Deal the room belongs to
linked_company
Relationship to the Company the room belongs to
  • An archived room keeps its record, with status set to archived.
  • Records for deleted rooms are removed. Re-sync on the Attio card in Settings → Integrations adds any missing rooms and cleans up any stale records.

Person records

foyai upserts a Person record for each identified room visitor: a buyer who enters their email at the room's gate. Existing Person records are matched by email and not duplicated. This happens whether or not the room is linked to a Company or Deal yet. A teammate who verifies with their own workspace address is never created as a Person.

A visitor is attached to the room's Company (and listed on the Deal's associated people, if the room is deal-linked) only when foyai can vouch for them:

  • Their email domain is on the room's allowed domains (seeded from the Company's domains when the room is linked). A room with no allowed domains attaches everyone.
  • They proved the address by clicking a magic link. Visitors who only typed an email at a domain check get a Person record and a note, but are not attached until they verify.
  • The Person is not already a contact of another Company. foyai never reassigns an existing contact's Company.

Stakeholders a seller adds by hand are always attached. To stop creating People from rooms that aren't linked to a Company or Deal, turn off Sync visitors on unlinked rooms on the Attio visitor sync card in Settings → Integrations. Linked rooms keep syncing either way, and activity on unlinked rooms while the setting is off is not backfilled.

Attributes Foyai writes on Deals

Attribute
What it stores
Update cadence
foyai_room_url
Buyer link to the room
Written once the room is published
foyai_room_edit_url
Link to edit the room in foyai (your team only)
When the room is created or linked to the Deal
foyai_engagement_score
0–100 over the last 30 days: recency of the last buyer visit (up to 40) + distinct stakeholders (up to 30) + sections viewed (up to 20) + plan completion (up to 10). Internal visits are excluded.
Debounced, about one minute after buyer activity
foyai_last_buyer_view
Timestamp of the most recent buyer visit
On buyer activity, with the engagement score
foyai_active_stakeholders
Count of the room's stakeholders
When the room's stakeholders change
foyai_map_completion
0–100: share of the room's action-plan tasks that are complete
When a plan task is completed or reopened

Attributes Foyai writes on Companies

Attribute
What it stores
foyai_room_url
Buyer link to the Company's room
foyai_room_edit_url
Link to edit the room in foyai (your team only)

foyai never modifies attributes outside these foyai_* attributes.

Notes Foyai writes

  • Foyai room activity: one note per buyer visit, written to the room's linked Deal or Company, with a link to the room's analytics. While the visit continues, the same note is refreshed rather than a new one added. Internal visits don't produce notes. On a room with no link yet, the note goes on the visitor's own Person record instead, and moves to the Company or Deal when the room is linked.
  • AI intelligence note: written only when a seller chooses to sync the room's AI intelligence to Attio.

Tasks Foyai writes

Tasks a seller adds to an action plan are created in Attio automatically. Steps suggested from calls are created only if the seller keeps them and chooses to sync them to Attio. Each Attio task includes the room's name and URL.

  • Deadline and completion stay in sync in both directions.
  • Completing the task in Attio is picked up by foyai when the room loads and while the plan is open.
  • Native Attio tasks (tasks foyai did not create) are never imported into a plan.
  • When a seller deletes a room that synced tasks, foyai offers to delete those Attio tasks too.

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 import your native Attio tasks.
  • We do not send your Attio data anywhere except the subprocessors and connected tools listed on the security page, to run foyai. For example, call transcripts go to Anthropic's API to draft a room.
  • Your data is not used to train AI models.

Related