Create device password

Create device password (app-specific password) for MailUsers (email accounts) who have 2FA enabled and/or password authentication disabled for logging in to IMAP/POP/SMTP clients.

  • HTTP Method: POST
  • URL: https://example.domain.tld/api/v1/2fa/device_password/
  • Require authentication: Yes
  • Permission level required: MailUser

Request parameters

Parameter Type Description Required
friendly_name str Name (identifier) for device password Required

Response parameters

Parameter Type Description
device_password str Device password
friendly_name str Name (identifier) of device password
username str Your account username

Example request (Python)

import requests
import json
from pprint import pprint

url = "https://example.domain.tld/api/v1/2fa/device_password/"
data = {
"friendly_name" : "Workstation"
}
r = requests.post(url, json=data, auth=("u2@vonmail.com","long-auth_token-here"))
try:
    pprint(r.json())
except: 
    print(r.text)

Example response (JSON)

{'device_password': 'xjrBKNe1A7VCO4KYxVfg',
 'friendly_name': 'Workstation',
 'username': 'u2@vonmail.com'}