mail_apikey_create

Tool

Issue a scoped sending API key; the full secret is returned only once

Name	Type	Required	Description
name	string	•	Human-readable label for the key, e.g. "production sender"
scope	string	•	Permission scope: full_access can call every mail tool, sending_access can only send email
domainId	string	—	Lock the key to this sending domain; omit to let it send from any verified domain

Field	Type	Always	Description
id	string	•	API key id; pass it to mail_apikey_delete to revoke the key
key	string	•	The full secret. Returned only by this call and never retrievable again — store it now
name	string	•	Human-readable label given when the key was issued
scope	string	•	Permission scope: full_access can call every mail tool, sending_access can only send email
prefix	string	•	Opening characters of the secret, so a key can be recognised in a log or a header
domainId	string	•	Sending domain this key is locked to; null if it may send from any verified domain
createdAt	string	•	When the key was issued (ISO 8601 UTC)

Issue a scoped sending API key; the full secret is returned only once.

When to use

Issue a scoped sending API key; the full secret is returned only once

Ask your agent something like this:

Issue a scoped sending API key; the full secret is returned only once.

The agent will invoke mail_apikey_create with these arguments:

{
  "name": "<name>",
  "scope": "<scope>"
}