Troubleshooting · troubleshooting

Recover email forwarding, sync, and delivery

Repair the correct shared-email path: inbound forwarding, history sync, outbound provider, routing, or delivery.

3 min readUpdated August 12, 2026
For
Owner, Admin, Member
Availability
Your current plan and entitlements
Product evidence
WRKZY · reviewed August 12, 2026
Editorial review
WRKZY Editorial
Before you begin
  • The affected shared or personal email connection and direction
  • An approximate timestamp and redacted message identifier
  • Access to receiving, sync, direct-send, and delivery-health evidence
  • Provider administration help when reauthorization is required

Identify the direction

Email path diagnosis
SymptomPathFirst evidence
External mail never appearsInbound forwardingProvider forwarding rule, generated WRKZY address, verification, receiving status
Old mail missingHistory synchronizationSelected start date, provider authorization, sync result
Reply cannot be sentOutbound connectionMicrosoft/Google/SMTP/fallback status and provider test
Send accepted but recipient did not receiveDeliveryMessage delivery state, bounce/suppression/provider event
Message arrived in wrong queueRoutingShared-email connection mapped to the wrong team inbox or assignment rule

Recover inbound forwarding

  1. Open Settings → Shared email and expand the affected inbox.
  2. Under Receiving, copy and compare the generated forwarding address with the mailbox provider rule.
  3. Confirm the provider completed any verification and the rule is enabled.
  4. Read inbound status and last error.
  5. Send one external test with a unique safe subject.
  6. Confirm it appears once in WRKZY and routes to the intended team inbox.

Do not point several business mailboxes to one connection unless that is the documented design.

Recover history synchronization

Confirm direct provider authorization is current and choose a narrow start date. If the error says provider authorization expired, reconnect the shared inbox. Run history import once and inspect imported scope before extending it. Do not keep restarting a long import or create a second connection.

Recover sending

For Microsoft or Google, send a Provider test email and verify the connected account and send-as address. For SMTP, check host, port, username, SSL setting, tenant policy, and test recipient. Microsoft 365 may reject SMTP when Authenticated SMTP is disabled; prefer Microsoft 365 connection or ask the tenant administrator to enable the supported path.

Never paste an SMTP password into support. Replace an exposed credential at the provider before reconnecting.

Recover delivery

Open Settings → Message delivery → Email. Inspect connection health, sent/delivered/failed state, bounces, complaints, and suppressions. An unsubscribe or complaint is compliance-protected and must not be removed just to resend. For an uncertain or delayed outcome, wait for provider evidence before duplicating the message.

Email state boundary

  1. 01
    LocalPrepared

    Content and recipient are ready but nothing has left WRKZY.

  2. 02
    PendingSubmitted

    WRKZY handed the request to the connected provider.

  3. 03
    AcceptedProvider accepted

    The provider accepted processing, not necessarily delivery.

  4. 04
    ResultDelivered or failed

    A terminal provider event confirms delivery or an exception.

  5. 05
    RecoverException reviewed

    An owner diagnoses, recovers safely, or escalates with evidence.

A send can be prepared or accepted without being delivered. Recover from the last state supported by provider evidence.

Escalation packet

Include connection ID/address, provider type, direction, forwarding status, last health/probe time, sync date range if relevant, message/delivery ID, provider reason, and safe test time. Exclude customer content, OAuth tokens, SMTP passwords, cookies, and unrelated recipients.

Email path restored
  • Failure direction identified
  • One connection—not a duplicate—repaired
  • Inbound rule or outbound provider test passed
  • History sync scope stayed controlled
  • Routing and terminal delivery verified
  • Compliance suppressions preserved
Was this guide useful?

Choose an answer. No message text or personal information is collected.

Still need help?

Contact WRKZY support with the workspace name and a safe, redacted example.

Contact support about this guide