# 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.