I am currently integrating the SmarterMail API into a production system and have spent the last two hours attempting to query the VerifyDkimActive endpoint to determine whether a domain has DKIM enabled.
/Documentation/api#/reference/SmarterMail.Web.Api.DomainSettingsController/VerifyDkimActive/post
POST api/v1/settings/domain/dkim-verify-active
states:
var input_post = { INPUT DATA HERE };But it does not specify what the input model actually is.
There is no schema, no example JSON body, no explanation of whether:
The domain is derived from token context,
A domain name must be supplied,
A domain ID must be supplied,
Or no body is required at all.
Every attempt results in 400 Domain not found, despite:
The documentation also does not clearly explain the difference between:
Nor does it clearly define which endpoints allow which HTTP methods. Several endpoints return 405 Method Not Allowed, yet the documentation does not clarify which methods are valid.
Additionally, the documentation site itself has:
No effective search functionality
No clear model definitions
No request/response schema examples beyond minimal placeholders
For developers building automated systems across multiple domains, this level of ambiguity makes integration unnecessarily difficult.
Could someone from the SmarterTools team please clarify:
The exact required JSON body schema for POST /api/v1/settings/domain/dkim-verify-active
Whether this endpoint requires a Domain Admin token bound to the target domain
The correct SysAdmin endpoint and method for retrieving DKIM settings (selector, public key, enabled state)
I am committed to SmarterMail, but the current API documentation makes implementation far more difficult than it should be.
Thank you.