> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yuzulabs.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Monaco

> Connect Monaco's revenue engine via API key — Yuzu syncs meetings, accounts, opportunities, contacts, tasks, and email drafts.

Monaco exposes meetings and CRM objects through its public API. Yuzu uses your Monaco API key to sync meetings, transcripts, accounts, opportunities, contacts, tasks, and email task drafts into your workspace.

**Auth method:** API key.

## Prerequisites

* A Monaco account with API access.
* Permission to create an API key in your Monaco workspace.

## Setup

<Steps>
  <Step title="Open Yuzu Settings → Integrations">
    Go to **Settings → Integrations**, click **Connect Notetaker**, and choose **Monaco**.
  </Step>

  <Step title="Create a Monaco API key">
    In Monaco, go to **Settings → API Keys → Create new key** and copy the key.

    <Frame />
  </Step>

  <Step title="Paste the key into Yuzu">
    Yuzu validates the key by calling Monaco's API. Email is optional — the API key already identifies the account.
  </Step>

  <Step title="Confirm the connection">
    Once the key validates, Yuzu kicks off a 7-day historical sync in the background.
  </Step>
</Steps>

<Note>
  Monaco is polling-based. Yuzu checks connected Monaco accounts every 30
  minutes because Monaco does not currently provide webhooks for this
  integration.
</Note>

## What gets pulled

Yuzu imports:

* Accounts into buyer accounts.
* Opportunities into deals, including stage, estimated amount, summary, risks, notes, tags, and custom fields as deal context.
* Contacts into deal contacts when an email is available.
* Tasks into deal tasks.
* Email task drafts into deal email events with a **Monaco** source label.
* Meetings and transcripts, including title, start/end time, organizer, attendees, meeting URL, recording URL, `meeting_summary`, `next_actions`, and diarized transcript segments.

## Email dedupe with Gmail

Monaco email tasks are provider activity copies. If Gmail is connected for the same seller, Yuzu searches Gmail for matching deal-contact conversations and prefers the Gmail thread when the same subject, participant, and time window match. That keeps Gmail replyable while still showing Monaco activity when Gmail does not have the message.

## Historical sync

From the connected state, click **Sync Meetings** and pick **Last 7 days**, **Last 2 weeks**, **Last 4 weeks**, or **All available Monaco data**. Existing records are updated or skipped rather than duplicated.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Yuzu rejected my API key">
    Monaco returns 401 on invalid keys. Double-check you copied the entire key
    and that it has not expired. Monaco strips non-printable characters when
    sending the key, so trailing whitespace or unusual characters are tolerated,
    but a wrong key will not pass validation.
  </Accordion>

  <Accordion title="A new meeting isn't appearing in Yuzu">
    Monaco is polled every 30 minutes. If the meeting still doesn't appear,
    click **Sync Meetings → Last 7 days** to force a refresh, then check the
    activity log for sync errors.
  </Accordion>

  <Accordion title="Transcripts arrive without good speaker labels">
    Monaco's diarization quality depends on the source recording. Multi-speaker
    calls without clear audio may collapse into a single speaker. This is
    upstream from Yuzu.
  </Accordion>
</AccordionGroup>