# Getting your API Key

<figure><img src="https://1835787252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV8CtRF59w8oxkhPMGwwB%2Fuploads%2FrMDySw1HQe2YUCT76u5a%2FChatGPT%20Image%209%20avr.%202025%2C%2009_30_52.png?alt=media&#x26;token=11325f7f-4604-406c-8d6b-c8c63787364f" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.
{% endhint %}

## Pre-requisite&#x20;

* You have an active MadKudu account&#x20;
* You are a MadKudu Admin

## How to create API keys

{% hint style="info" %}
Your API keys are personal, they are tied to your user and your permissions. You can create different ones for different integrations.&#x20;
{% endhint %}

1. Log into MadKudu admin console: [https://admin.madkudu.com](https://admin.madkudu.com/org/3327)
2. On the left navigation bar, go to **Personal Settings** then **My API Keys**
3. Click **Create API key**

<figure><img src="https://1835787252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV8CtRF59w8oxkhPMGwwB%2Fuploads%2Fv4usiCerYv3BSof3oUn6%2FScreenshot%202025-06-18%20at%2016.01.00.png?alt=media&#x26;token=a860eb8c-e76d-43b8-811c-117cd01cd7db" alt=""><figcaption></figcaption></figure>

4. Give it a name after the integration or tool you’ll use it with (e.g. "Cursor", "Zapier", "Claude"...)
5. Once created, you can copy you key:

<figure><img src="https://1835787252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV8CtRF59w8oxkhPMGwwB%2Fuploads%2FGncTyiceLERMG58YrZD3%2FScreenshot%202025-06-18%20at%2016.01.32.png?alt=media&#x26;token=a5f132b0-c444-4296-bb1b-127136700eac" alt=""><figcaption></figcaption></figure>

## View your API keys

1. Log into MadKudu admin console: [https://admin.madkudu.com](https://admin.madkudu.com/org/3327)
2. On the left navigation bar, go to **Personal Settings** then **My API Keys**
3. You can see the list of all your API keys, and copy them

<figure><img src="https://1835787252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV8CtRF59w8oxkhPMGwwB%2Fuploads%2Fshn80R2tCQ6yxFCI64lQ%2FScreenshot%202025-06-18%20at%2016.24.01.png?alt=media&#x26;token=c3e1f9ba-2093-4d57-8762-0c70767f0653" alt=""><figcaption></figcaption></figure>

## How to Use the API Key

### with MadKudu MCP

You'll use the API key when installing MadKudu MCP in your AI tools. Please[ follow instructions here](https://developers.madkudu.com/madkudu-mcp/what-is-madkudu-mcp)

### with MadKudu API

The MadKudu API uses API keys to authenticate requests.

All API requests must be made over [HTTPS](http://en.wikipedia.org/wiki/HTTP_Secure). Calls made over plain HTTP will fail.&#x20;

The API Key must be passed in the `X-API-Key` header for **every requests**. API requests without authentication will also fail.