> For the complete documentation index, see [llms.txt](https://docs.adnuntius.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adnuntius.com/adnuntius-advertising/admin-api/endpoints/authenticate.md).

# /authenticate

Handles User log-in and provides Authentication Tokens.

| Name           | Type   | Constraints      | Description                          |
| -------------- | ------ | ---------------- | ------------------------------------ |
| grant\_type    | String | "password" or "" | Defines the scope of the grant type. |
| password       | String |                  | Authenticating users password        |
| username       | String |                  | Authenticating users username        |
| refresh\_token | String |                  |                                      |
| scope          | String | "ng\_api"        | Describes what API to access.        |

Example authentication using grant type `password`

```
POST https://api.adnuntius.com/api/authenticate?context={{context}}
```

```javascript
{
    "grant_type": "password",
    "scope": "ng_api",
    "username": "{{adn-username}}",
    "password": "{{adn-password}}"
}
```

Example authentication using grant type `refresh_token`

```
POST https://api.adnuntius.com/api/authenticate?context={{context}}
```

```javascript
{
    "grant_type": "refresh_token",
    "scope": "ng_api",
    "refresh_token": "TK0eTkcK7TiNzrAsBpfaSTu1NVPKWhmdcjMLO..."
}
```

Example response for all grant types:

```javascript
{
    "access_token": "VaOHWOyKRLQkkoO6yATH0Tc2RQcKxHsJssTxvg...",
    "token_type": "bearer",
    "expires_in": "3600",
    "refresh_token": "TK0eTkcK7TiNzrAsBpfaSTu1NVPKWhmdcjMLO..."
}
```