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

# Troubleshooting

> Fix the most common issues in Bizzy, with links to detailed guides

Find the symptom below, try the quick fix, and follow the link for the full
guide. If Bizzy itself seems down, check
[status.bizzyco.ai](https://status.bizzyco.ai) before debugging your own setup.

## Email & inbox

<AccordionGroup>
  <Accordion title="Connecting Google or Microsoft fails">
    "Access denied" usually means your workspace blocks third-party apps —
    ask your IT administrator to approve Bizzy. An "invalid grant" error
    means the authorization expired: disconnect and reconnect the account.
    See [Connect Email →
    Troubleshooting](/user-guide/email/connect#troubleshooting).
  </Accordion>

  <Accordion title="Emails aren't appearing in the inbox">
    The initial sync can take a few minutes, and only emails from the last
    30 days are synced. If a previously connected account stopped syncing,
    its token may have been revoked — reconnect it from the **Email
    Addresses** page. See [Connect Email →
    Troubleshooting](/user-guide/email/connect#troubleshooting).
  </Accordion>
</AccordionGroup>

## Domains & DNS

<AccordionGroup>
  <Accordion title="Domain verification keeps saying 'not found'">
    TXT records can take 5–30 minutes to propagate, and the record must be
    at `_bizzy.<your-domain>` — not on the apex. See [Verify a Domain →
    Troubleshooting](/user-guide/domains/verify#troubleshooting).
  </Accordion>

  <Accordion title="Emails from my domain land in spam">
    Sending reputation depends on your domain's authentication records being
    verified and warmed up. See
    [Deliverability](/user-guide/domains/deliverability).
  </Accordion>
</AccordionGroup>

## Phone numbers

<AccordionGroup>
  <Accordion title="No numbers come up in search">
    Your filters are probably too narrow or the area code is out of stock.
    Loosen the pattern, switch the type to **Any**, or try a nearby area
    code. See [Buying a Number →
    Troubleshooting](/user-guide/phone-numbers/buying#troubleshooting).
  </Accordion>

  <Accordion title="A connected number stopped working">
    Check the number's status on the **Phone Numbers** page — you'll also
    get a "Connection lost" notification when a number goes offline. See
    [Configuring Numbers](/user-guide/phone-numbers/configuring).
  </Accordion>
</AccordionGroup>

## Agents & automations

<AccordionGroup>
  <Accordion title="An agent can't see a file I uploaded">
    The file's **Agent access** flag is probably off (it's off by default for
    privacy), or indexing hasn't finished — give it a minute after enabling.
    See [Agent Access & RAG Indexing](/user-guide/files/rag-indexing).
  </Accordion>

  <Accordion title="An automation didn't fire">
    Check that the automation is **Active** (not paused, completed, or
    expired) and that its trigger matches the event. See
    [Your First Automation → Troubleshooting](/user-guide/automations/first-automation#troubleshooting).
  </Accordion>

  <Accordion title="AI features suddenly stopped working">
    You may have hit your monthly usage allowance — at the cutoff threshold,
    AI features pause until you buy credits, upgrade, or the billing cycle
    resets. Check **Settings > Account > Billing**. See
    [Understanding Limits](/admin-guide/billing/limits).
  </Accordion>
</AccordionGroup>

## API & MCP

<AccordionGroup>
  <Accordion title="API returns 401 or 403">
    A `401` means the API key is missing or invalid; a `403` means the key
    lacks the permission scope for that endpoint. Check your key on the
    **API Keys** page. See [Error Handling](/api-reference/errors).
  </Accordion>

  <Accordion title="API returns 429 (rate limited)">
    You've exceeded your plan's per-minute request limit. Wait the number
    of seconds given by the `Retry-After` header, then retry. See [Rate
    Limits](/api-reference/rate-limits) for the limits on each plan.
  </Accordion>

  <Accordion title="MCP client can't connect or authenticate">
    Re-run the OAuth flow from your client and approve the consent screen —
    and make sure the client points at `https://mcp.bizzyco.ai`. See [MCP
    Connection → Troubleshooting](/mcp-server/connection#troubleshooting).
  </Accordion>

  <Accordion title="MCP tool call fails with error code -32004">
    You've exceeded your plan's per-minute MCP request limit. The HTTP
    response looks normal — the throttle is reported inside the JSON-RPC
    error, so wait `data.retryAfter` seconds before retrying. See [MCP Rate
    Limits](/mcp-server/authentication#rate-limits) for the limits on each
    plan.
  </Accordion>
</AccordionGroup>

## Still stuck?

For API issues, grab the `X-Request-ID` header from the failing response — it
lets support find your exact request. See
[Getting Support](/user-guide/help/support) for what else to include.

<CardGroup cols={2}>
  <Card title="Getting Support" icon="life-ring" href="/user-guide/help/support">
    Contact the team with the right details
  </Card>

  <Card title="Service Status" icon="signal-bars" href="https://status.bizzyco.ai">
    Check for ongoing incidents
  </Card>
</CardGroup>