Se connecter avec une seule adresse
Un mot de passe propre permet à quelqu'un de se connecter à OpenEmail avec une seule adresse, et de lire et d'envoyer uniquement son courrier.
Exécute l'un des 3 appels sur votre espace de travail.
GET /domains/{id}/addresses/{addressId}/login
Un mot de passe propre permet à quelqu'un de se connecter à OpenEmail avec une seule adresse, et de lire et d'envoyer uniquement son courrier.
Lire la connexion
Nécessite members:write, comme la définition d'un mot de passe. login vaut null quand l'adresse n'a pas de mot de passe.
curl "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/login" -H "$AUTH"{ "object": "address_login", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "address": "[email protected]", "login": { "userId": "W2xR8tLq5nYc3vKp9mBd7fHs1aJe4gZu", "name": "Invoices", "createdAt": "2026-09-20T09:30:00.000Z", "createdBy": "Ana Lima", "passwordSetAt": "2026-09-28T14:05:00.000Z", "passwordSetBy": "Ana Lima", "lastSignedInAt": "2026-10-01T07:58:12.000Z" }}Une clé limitée à certaines adresses ou certains domaines est refusée avec 422 capability_unsupported, et une application qui agit pour un membre n'atteint que la connexion d'une adresse que ce membre atteint.
Définir le mot de passe
Nécessite members:write. PUT /domains/{id}/addresses/{addressId}/login avec { password } donne un mot de passe à l'adresse, ou remplace celui qu'elle a. created indique si la connexion est nouvelle.
curl -X PUT "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/login" -H "$AUTH" \ -H "Content-Type: application/json" \ -d '{ "password": "'"$INBOX_PASSWORD"'" }'{ "object": "address_login", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "address": "[email protected]", "login": { "userId": "W2xR8tLq5nYc3vKp9mBd7fHs1aJe4gZu", "name": "Invoices", "createdAt": "2026-09-20T09:30:00.000Z", "createdBy": "Ana Lima", "passwordSetAt": "2026-09-28T14:05:00.000Z", "passwordSetBy": "Ana Lima", "lastSignedInAt": "2026-10-01T07:58:12.000Z" }, "created": false}Le mot de passe doit compter au moins 8 caractères, dont une minuscule, une majuscule, un chiffre et un caractère spécial, sinon l'appel donne un 422 invalid_parameter sur password. OpenEmail ne l'envoie à personne, transmettez-le donc vous-même.
Remplacer un mot de passe déconnecte toutes les personnes qui se sont connectées avec l'ancien et retire les destinations de transfert qu'elles ont ajoutées.
Une adresse avec laquelle un compte OpenEmail se connecte déjà est refusée avec 409 account_exists, et une adresse désactivée avec 409 address_unavailable. Le premier mot de passe d'un espace de travail dont l'offre n'inclut pas l'accès d'équipe est refusé avec 403 plan_required.
Une clé ou une application doit détenir chaque portée qu'une connexion pour une seule adresse peut utiliser, sinon elle est refusée avec 403 insufficient_authority.
Un jeton d'accès OAuth a besoin d'un code de vérification pour cet appel. Tant que l'application n'en a pas vérifié un dans les 60 dernières minutes, l'appel répond 403 step_up_required et ne change rien. On ne le demande jamais à une clé API. La page Authentification montre comment demander un code et le vérifier.
Supprimer la connexion
Nécessite members:write. DELETE /domains/{id}/addresses/{addressId}/login retire le mot de passe et déconnecte toutes les personnes qui l'ont utilisé. L'adresse et son courrier restent.
curl -X DELETE "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/login" -H "$AUTH"{ "object": "address_login", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "address": "[email protected]", "deleted": true}Une adresse sans mot de passe donne un 404.