Create SMTP Credential
Creates a new SMTP credential for SMTP authentication. A scoped
credential requires at least one domain and the key must have write
permission for every supplied domain. A global credential requires
smtp-credentials:write:all; supplied domains are accepted but ignored,
and the response contains domains: []. SMTP credentials have no
update endpoint.
Authorizations
API key for authentication. Non-empty Security Requirement values are AhaSend API-key roles. Roles listed within one requirement object are jointly required; separate requirement objects are alternatives.
Headers
Optional idempotency key for safe request retries. Must be a unique string for each logical request.
An identical request with a completed stored outcome returns the original status and body. An in-progress
execution returns 409, a changed method/path/body returns 422, and a released 5xx execution may run again.
Keys for non-secret responses expire after 24 hours. API-key create responses include a one-time secret_key,
so successful encrypted replay responses for those operations expire after 5 minutes.
255Path Parameters
Account ID
Body
Credential name
255Credential scope - "global" or "scoped"
global, scoped Whether this is a sandbox credential
For scoped, a non-empty array is required. For global, this may
be omitted, null, empty, or non-empty; supplied values are accepted
but ignored.
Response
SMTP credential created successfully
Object type identifier
credential_smtp Unique identifier for the SMTP credential
When the credential was created
When the credential was last updated
Credential name
SMTP username
Whether this is a sandbox credential
Credential scope
global, scoped Domains this credential can send from. Always present; global credentials return an empty array.
SMTP password. Returned only when the credential is created.

