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

# Authentication

In your omnidesk application a key can be created to which certain permissions will be granted. You could for instance assign customer creation and deletion to a key. Most permissions are devided in two categories: READ permissions and CUD (create update delete) permissions for a given endpoint. Once you have created a key and given it permissions you will be able to authenticate with it by sending ?apiKey=\[\[ your key ]] in the API url.

{% hint style="info" %}
An example would be: <https://account.omnidesk.com/api/v2/customer?apiKey=14fasf35435sdgsdgksjh235>. Since this is a GET request for the customer endpoint it will list all customers, limited by paging.
{% endhint %}