> For the complete documentation index, see [llms.txt](https://docs.txn.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.txn.io/getting-setup/creating-your-api-keys.md).

# Creating your API keys

Once your business account is set up and active, you can create your API keys to authenticate against the Txn API.

To do so, navigate to the **Developers** page on the left-hand menu in your account and click the blue "Add API Key" button. You will be asked to provide the API key label, API key permission (full access or read only) and your OTP code.

| API Key Permission | Description                                              |
| ------------------ | -------------------------------------------------------- |
| Read               | Can only read data, e.g. transaction details.            |
| Full Access        | Can read and write data, e.g. create quotes and payouts. |

Each newly generated API key is shown only once — copy and store it securely, as it cannot be retrieved from your account later.

If you'd like to delete your API key, navigate to the Developers page again to view the list of all API keys associated with your account and click the grey "Delete" button next to the relevant API key.

{% hint style="info" %}
To whitelist your server IP addresses for a given API key, please reach out to us via the integration channel.
{% endhint %}

<figure><img src="/files/3s5SnFpJ2fTdaTGpKkfd" alt="API Keys page"><figcaption><p>Developers → API Keys</p></figcaption></figure>

<figure><img src="/files/ofD8COUnXRbl9ewGg2JA" alt="Create new API key — step 1"><figcaption><p>Step 1: Enter a label and choose the key permission</p></figcaption></figure>

<figure><img src="/files/LebEfqB4qRGKJJnVQvBZ" alt="Create new API key — step 2"><figcaption><p>Step 2: Confirm with your authenticator app code</p></figcaption></figure>

<figure><img src="/files/gpakn3CRKM6wHxWDJ7jE" alt="Create new API key — step 3"><figcaption><p>Step 3: Copy and save the key — it is shown only once</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.txn.io/getting-setup/creating-your-api-keys.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
