Self-service create API key (cliente, con cap por plan)
POST
/v1/client/keys
const url = 'https://api.mailerdash.com/v1/client/keys';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"label":"example","password":"example","allowed_from_domains":["example"]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.mailerdash.com/v1/client/keys \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "label": "example", "password": "example", "allowed_from_domains": [ "example" ] }'Cliente crea una nueva API key vinculada a su cuenta. Cap por package transactional (packages.max_api_keys — Free=2, Starter=5, Pro=20). Token devuelto UNA SOLA VEZ en la response — el cliente debe copiarlo al crear. Re-auth password obligatorio.
Authorizations
Sección titulada «Authorizations »Request Body required
Sección titulada «Request Body required » Media type application/json
object
label
required
Display name de la key, ej “production-app”
string
password
required
Re-auth password del cliente
string
allowed_from_domains
Dominios verificados que la key puede usar como from. Vacío = cualquiera.
Array<string>
Example generated
{ "label": "example", "password": "example", "allowed_from_domains": [ "example" ]}Responses
Sección titulada « Responses »Key creada
Media type application/json
object
id
string
label
string
token
ONE-TIME. Copiar inmediato — no se vuelve a mostrar.
string
allowed_from_domains
Array<string>
Example generated
{ "id": "example", "label": "example", "token": "example", "allowed_from_domains": [ "example" ]}Validation error (label vacío, dominios inválidos)
Password incorrecto
Max_api_keys_exceeded — cap del plan alcanzado