Skip to main content
POST
AhaSend Go SDK

Authorizations

Authorization
string
header
required

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

Idempotency-Key
string

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.

Maximum string length: 255

Path Parameters

account_id
string<uuid>
required

Account ID

Body

application/json
name
string
required

Credential name

Maximum string length: 255
scope
enum<string>
required

Credential scope - "global" or "scoped"

Available options:
global,
scoped
sandbox
boolean
default:false

Whether this is a sandbox credential

domains
string[] | null

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
enum<string>
required

Object type identifier

Available options:
credential_smtp
id
string<uuid>
required

Unique identifier for the SMTP credential

created_at
string<date-time>
required

When the credential was created

updated_at
string<date-time>
required

When the credential was last updated

name
string
required

Credential name

username
string
required

SMTP username

sandbox
boolean
required

Whether this is a sandbox credential

scope
enum<string>
required

Credential scope

Available options:
global,
scoped
domains
string[]
required

Domains this credential can send from. Always present; global credentials return an empty array.

password
string
required

SMTP password. Returned only when the credential is created.