Fix agent access: API keys, connector links, webhooks and approvals
Loading progress…
Agent key lost or not working? Open Settings > Agent access, turn access on (owner), then issue, rotate or revoke the key. Full keys are shown once.
Outcome
The AI agent connects with a working key or link, you can see what it did, and actions that need approval are handled.
Last reviewed
2026-10-24 · Support
Before you begin
- Owner or admin role. Only an owner can turn agent access on, accept the disclosure and buy credits.
Open the right workspace
- 1Sign in and open Dashboard.
- 2Choose Settings, then press the Agent access button next to the Settings tabs (it is a button, not a tab).
- 3If your role is view-only you will see "Agent access is not available for your role"; ask an owner.
Fix the key, link or approval
- 1Owner: if the switch is Disabled, press Enable agent access, tick "I understand and agree to enable agent access" and confirm. Nothing below works until it is Enabled.
- 2Under Connected agent clients, open the client (or press New client), then Issue new key. Under "What to issue" choose API key (Claude Code, Codex, tools that send an Authorization header) or Connector link (Claude Cowork and claude.ai custom connectors), pick a Quick pick such as Read only, and press Issue key.
- 3Copy the key or link straight away from "Copy this key now" and press "Done, I've saved it". It is shown only once and Mawidi cannot show it again; if it is lost, issue a new one and revoke the old one.
- 4To change a key, press Rotate and choose "Keep the old key working for 7 days" for a routine change, or "Stop the old key now" if it leaked (or press Revoke, which is immediate and cannot be undone). A rotation can only narrow permissions; issue a new key to widen them.
- 5Approvals: press "Review actions waiting for your approval" (a small badge shows how many wait, when any do), read What will happen, then Approve and run or Decline. Owners and admins can approve; actions that move money need the owner plus an identity check.
Agent webhooks, credits and transcript access (this screen only)
- 1Agent webhooks are on Settings > Agent access, inside each client: open the client and find the Outbound webhooks card. They push booking updates and cancellations to your own HTTPS address. Webhooks for Zapier, Make, Google Sheets or order events are a different system under Settings > Integrations (see the outbound webhooks guide).
- 2Add endpoint: enter an https:// address without username, password or query string, choose Booking updated and/or Booking cancelled, press Create endpoint, and copy the signing secret from "Copy your signing secret now". It is shown once; use it to check the X-Mawidi-Signature header, and press Rotate secret if it is lost.
- 3A status of "Stopped after repeated failures" means your receiver kept failing: fix your system first, then press Resume. Pause, Rotate secret and Delete stay available even when agent access is off.
- 4Credits: the Agent credits card shows Available credits and, for owners, a Buy credits button for each pack (a Stripe checkout opens). The card appears only when credit purchase is open for your account. Credits are charged when an action runs, not while it waits for approval.
- 5If a banner says "The agent access disclosure has changed", an owner must press Review and accept, then Accept updated disclosure. Until then existing keys keep working but you can only issue read-only keys.
- 6Transcript access: where your account shows the Browser AI assistant card, only the owner can turn on transcript access (tick the agreement, then Turn on transcript access); an owner or admin can turn it off. It is off by default.
Check before contacting Support
- 1Note the page (Agent access, a client, Outbound webhooks or Reviews), the exact message shown, the time, the client name and the key name or last characters shown in the Key column. Never send the full key, link or signing secret.
How to know it worked
- • The client shows Active, the key or link is saved by the agent and its Last used time updates.
If something goes wrong
- I lost the key or closed the "Copy this key now" box: the full key is never shown again; issue a new key under the client, update the agent, then Revoke the old key.
- The agent was working and suddenly stopped: check the client status. If it says Suspended (this happens to every client when agent access is turned off), an owner turns access on again and presses Reactivate on the client; re-enabling does not reactivate suspended clients by itself.
- A connector link shows "Stopped (unused for 30 days)": a link nobody used for 30 days stops working; issue a new connector link and give it to the assistant.
- "Creating or replacing a key needs you to verify your identity again": try the action again and complete the verification prompt.
- "Issuing a key that can change data or needs approvals requires an owner to accept the updated agent access disclosure first": an owner presses Review and accept in the banner; read-only keys can be issued meanwhile.
- "This client has reached the maximum of ... active keys" or "maximum number of agent clients": revoke a key you no longer use, or reuse an existing client; raising the client limit is done by Mawidi staff, so send the page and the message in a Support ticket.
- "Agent access is not open for new companies right now": only Mawidi staff can open access for your company; send a Support ticket with your company name and this message.
- The agent webhook shows "Stopped after repeated failures" or Consecutive failures keeps rising: make sure your address answers with a success response, then press Resume; if the address was wrong, Delete it and add the correct one.
- "That URL was not accepted" style errors (must start with https://, no query string, no private or internal address): use a public https address with no username, password, ? or #; only the default HTTPS port or 8443 is allowed.
- An approval fails with "This action cannot run right now. The request is still waiting": it stays in the list under Waiting, so try Approve and run again later; "Only the organization owner can approve an action that moves money" means ask the owner.
- No Buy credits button: credit purchase is not open for your account, or you are not the owner, or agent access is off; once a purchase shows "awaiting payment", credits appear after Stripe confirms it.