---
title: "Generates an authentication token for API access."
method: POST
path: "/auth/login"
tags: ["authentication"]
---

# Generates an authentication token for API access.

`POST /auth/login`

## Request

- Base URL: `https://authentication.digicertdns.com/v1`
- URL: `https://authentication.digicertdns.com/v1/auth/login`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/digicert/apis/digicert-dns/docs/auth/login/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint generates a time-sensitive authentication token, enabling secure access to the system's API.</br></br>Key features include:</br></br>- **Clear success messaging:** Returns a `200` success code with a confirmation message indicating the successful completion of the requested action.</br>- **Comprehensive error handling:** Returns `401` and `403` error codes with clear descriptions and resolution suggestions when requests fail.</br>- **Seamless token generation:** Facilitates the generation of an authentication token in-line with the appropriate schema, ensuring smooth and efficient organization.

## Response `200`

Token generated successfully.

- AuthToken
  - `access_token` string
  - `fullname` string
  - `username` string
  - `federated_user_id` string
  - `expires_in` integer
  - `token_type` string
  - `scopes` AuthTokenScopes[]
    - `name` boolean

## Other responses

- `401`: Token is missing or expired.
- `403`: Request is forbidden.

---

[API](https://skmtc.dev/digicert/apis/digicert-dns.md) - [All operations](https://skmtc.dev/digicert/apis/digicert-dns/llms.txt) - [OpenAPI document](https://skmtc.dev/digicert/apis/digicert-dns/revisions/c74fc728cff8?raw)