---
title: API Key Troubleshooting
description: reviews common api key issues and how to troubleshoot
---

[Skip to content](https://support.govspend.com/api-key-troubleshooting#main-content)

English

Show submenu for translations

[![GS Logo-GS platform.png\]](https://support.govspend.com/hs-fs/hubfs/GS%20Logo-GS%20platform.png?height=25&name=GS%20Logo-GS%20platform.png)](https://support.govspend.com/?hsLang=en)

- [Home](https://support.govspend.com/)
- [Email Support](mailto:support@govspend.com)
- [Product Health Status](https://support.govspend.com/product-health-status)
- [What's New](https://support.govspend.com/)
  
  Show submenu for What's New

    - [New User Onboarding](https://support.govspend.com/govspend-onboarding-journey)
    - [Releases & Updates](https://support.govspend.com/releases-updates)
    - [Newsletters](https://support.govspend.com/newsletter-archive)
- [Sales Training Videos](https://app.govspend.com/trainingVideos)

Open main navigation

Close main navigation

- [Home](https://support.govspend.com/)
- [Email Support](mailto:support@govspend.com)
- [Product Health Status](https://support.govspend.com/product-health-status)
- [What's New](https://support.govspend.com/)
  
  Show submenu for What's New

    - [New User Onboarding](https://support.govspend.com/govspend-onboarding-journey)
    - [Releases & Updates](https://support.govspend.com/releases-updates)
    - [Newsletters](https://support.govspend.com/newsletter-archive)
- [Sales Training Videos](https://app.govspend.com/trainingVideos)
- English
  
  Show submenu for translations
- [Log into GovSpend](https://app.govspend.com/)

[Log into GovSpend](https://app.govspend.com/)

 Skip the browsing—search for the fastest, most relevant results.

- There are no suggestions because the search field is empty.

1. [GovSpend Help Center](https://support.govspend.com/?hsLang=en)
2. [Integrations & Add-Ons](https://support.govspend.com/integrations-add-ons?hsLang=en)
3. [Other Integrations](https://support.govspend.com/integrations-add-ons?hsLang=en#other-integrations)

# API Key Troubleshooting

## This article reviews common issues or errors that could arise when using API keys and how to resolve them

#### If you use an API key to connect to the GovSpend API or MCP, the below documentation reviews common errors and suggested resolutions if you encounter issues. If you still can't resolve any issue you are having, please reach out to our customer support team ([support@govspend.com](mailto:support@govspend.com)).

For instructions on how to create an API key [click here](https://support.govspend.com/search-api?hsLang=en).

**A Few Important Notes & Best Practices to Manage Your API Keys:**

- You can only have one API key at a time. Creating a new key will replace any existing key in use. Integrations using the older key will stop working as soon as the new key is created.
- You can only copy your API key the FIRST time you create it. Make sure to save it if you know you will need access to it later. If you need it in the future you will not be able to view or recopy the full key, in which case it's best to create a new API key and replace that across your applications.
- Keys depend on their creator. Make sure to rotate keys if the creator leaves the organization as the existing API key will no longer work.

### Common API Key Errors & Fixes

#### **Any use case (GovSpend API, MCP, other applications)**

| Symptom / message | Likely cause | Suggested fix |
| --- | --- | --- |
| API Key not found | The key was revoked (deleted), mistyped or only partly copied | Check the key on Account → API Keys. If it was revoked, [create a new one](https://support.govspend.com/search-api?hsLang=en). Paste the whole key with no spaces, quotes or line breaks. |
| API Key not found for a key that used to work | The user who created the key has been removed. The lookup joins the key to its creator, so the key stops resolving | Have an active user in the organization create a new key, then update every integration that used the old one |
| Required permissions missing: \<permissions\> (403) | The user tied to the API key doesn't have permission for the particular action | Give the user who owns the key the needed permission, or use a key created by a user who has it |
| 403 on the token endpoint | The key's creator doesn't have the Admin permission in GovSpend | Use a key created by an organization Admin, or give that user the Admin role. Any Admin can manage user roles, or your Relationship Manager can help |
| 404 email address not found (token endpoint) | The email in scope isn't a user in your organization | Check the email address of the user with the API key and that the user belongs to the organization |
| Key works for one teammate's tasks but not another's | Keys inherit their creator's permissions, not the caller's | Use a separate key per integration or user, created by an account with the right access |

**GovSpend API Endpoints**

| Symptom / message | Likely cause | Suggested fix |
| --- | --- | --- |
| No API Key found! (400) | A Basic Auth header was sent with an empty username | Put the key in the username field, or switch to the `X-API-KEY` header |
| 401 Not Authenticated | No key was sent at all, or the header name is misspelled (for example `X-API-TOKEN` or `API-KEY`) | Send the key in the `X-API-KEY` header exactly |
| Key exposed in logs or browser history | The key was passed as the `?apiKey=` query parameter | Use the header instead. If the key was exposed, revoke it and issue a new one. |

**MCP (Cluade, ChatGPT, and similar clients)**

| Symptom | Likely cause | Suggested fix |
| --- | --- | --- |
| The client connects, but every tool call fails with an auth error | The MCP server only checks that a token is present when you connect. The key is actually checked when a tool calls the GovSpend API, so a revoked or wrong key looks fine until the first tool call. | Check the key on Account → API Keys and replace it in the client's MCP settings |
| The connection is refused right away (401) | The token is empty, or the header isn't `Authorization: Bearer <key>` | Use the format `Authorization: Bearer <your key>`, with the word "Bearer" and a space before the key |
| 401 on every tool call after signing in with OAuth (WorkOS) | Your GovSpend key isn't linked to your OAuth identity, or the link is broken | Sign out of the MCP connection in your client and sign in again. If it keeps failing, contact support. |
| The key still fails after you replace it | The client is still holding the old key | Restart the MCP client or remove and re-add the server |

- [Getting Started](https://support.govspend.com/getting-started?hsLang=en#main-content)

    - [New User Onboarding](https://support.govspend.com/getting-started?hsLang=en#new-user-onboarding)
- [Free Trial Guides](https://support.govspend.com/free-trial-guides?hsLang=en)
- [The Lab](https://support.govspend.com/the-lab?hsLang=en#main-content)

    - [\[Concept & Design\] Potential Upcoming Features](https://support.govspend.com/the-lab?hsLang=en#concept-design-potential-upcoming-features)
    - [\[Beta\] GovSpend Slack App](https://support.govspend.com/the-lab?hsLang=en#beta-govspend-slack-app)
- [Searching & Filtering](https://support.govspend.com/searching-filtering?hsLang=en#main-content)

    - [General Search](https://support.govspend.com/searching-filtering?hsLang=en#general-search)
    - [Module-Specific Search](https://support.govspend.com/searching-filtering?hsLang=en#module-specific-search)
    - [Workflow Tips](https://support.govspend.com/searching-filtering?hsLang=en#workflow-tips)
- [AI & Automation](https://support.govspend.com/ai-automation?hsLang=en#main-content)

    - [AI Access Points](https://support.govspend.com/ai-automation?hsLang=en#ai-access-points)
    - [Opportunities Module](https://support.govspend.com/ai-automation?hsLang=en#opportunities-module)
    - [MCP (Model Context Protocol) Server](https://support.govspend.com/ai-automation?hsLang=en#mcp-model-context-protocol-server)
    - [AI Prompts & Chat](https://support.govspend.com/ai-automation?hsLang=en#ai-prompts-chat)
    - [AI Notebook](https://support.govspend.com/ai-automation?hsLang=en#ai-notebook)
    - [AI Search](https://support.govspend.com/ai-automation?hsLang=en#ai-search)
- [Integrations & Add-Ons](https://support.govspend.com/integrations-add-ons?hsLang=en#main-content)

    - [\[CRM Integration\] Introduction](https://support.govspend.com/integrations-add-ons?hsLang=en#crm-integration-introduction)
    - [\[CRM Integration\] Setup: Tech Onboarding](https://support.govspend.com/integrations-add-ons?hsLang=en#crm-integration-setup-tech-onboarding)
    - [\[CRM Integration\] Quick Start Guide](https://support.govspend.com/integrations-add-ons?hsLang=en#crm-integration-quick-start-guide)
    - [\[CRM Integration\] Additional Features](https://support.govspend.com/integrations-add-ons?hsLang=en#crm-integration-additional-features)
    - [Other Integrations](https://support.govspend.com/integrations-add-ons?hsLang=en#other-integrations)
    - [Add-Ons](https://support.govspend.com/integrations-add-ons?hsLang=en#add-ons)
- [Training Webinars](https://support.govspend.com/training-webinars?hsLang=en#main-content)

    - [Platform Training](https://support.govspend.com/training-webinars?hsLang=en#platform-training)
    - [Platform Strategy](https://support.govspend.com/training-webinars?hsLang=en#platform-strategy)
    - [Webinar Series | Beyond the Bid: Industry Insights That Win](https://support.govspend.com/training-webinars?hsLang=en#webinar-series-beyond-the-bid-industry-insights-that-win)
- [Report Templates](https://support.govspend.com/report-templates?hsLang=en)
- [Releases & Updates](https://support.govspend.com/releases-updates?hsLang=en#main-content)

    - [2026 Product Enhancements](https://support.govspend.com/releases-updates?hsLang=en#2026-product-enhancements)
    - [2025 Product Enhancements](https://support.govspend.com/releases-updates?hsLang=en#2025-product-enhancements)
    - [2024 Product Enhancements](https://support.govspend.com/releases-updates?hsLang=en#2024-product-enhancements)
    - [2023 Product Enhancements](https://support.govspend.com/releases-updates?hsLang=en#2023-product-enhancements)
    - [Newsletters](https://support.govspend.com/releases-updates?hsLang=en#newsletters)
- [Data Overviews](https://support.govspend.com/data-overviews?hsLang=en#main-content)

    - [Document Repository](https://support.govspend.com/data-overviews?hsLang=en#document-repository)
- [Quotes & RFQs](https://support.govspend.com/quotes-rfqs?hsLang=en#main-content)

    - [For Companies](https://support.govspend.com/quotes-rfqs?hsLang=en#for-companies)
    - [For Agencies](https://support.govspend.com/quotes-rfqs?hsLang=en#for-agencies)
- [Technical Support](https://support.govspend.com/technical-support?hsLang=en)
- [Agency Launchpad](https://support.govspend.com/agency-launchpad?hsLang=en)
- [GovSpend Federal](https://support.govspend.com/govspend-federal?hsLang=en#main-content)

    - [Introduction](https://support.govspend.com/govspend-federal?hsLang=en#introduction)
    - [Search Modules](https://support.govspend.com/govspend-federal?hsLang=en#search-modules)
    - [Opportunities](https://support.govspend.com/govspend-federal?hsLang=en#opportunities)

[![Chill listening crop-3](https://support.govspend.com/hs-fs/hubfs/GS%20Logo-GS%20platform.png?width=109&height=24&name=GS%20Logo-GS%20platform.png "Chill listening crop-3")](https://support.govspend.com?hsLang=en)

[Privacy](https://govspend.com/privacy/) | [Terms](https://govspend.com/terms/)

<https://www.linkedin.com/company/24993760/> <https://www.facebook.com/GovSpend.us/> <https://twitter.com/govspend_> <https://www.instagram.com/govspend_>

Copyright © 2025 GovSpend