Models Hub
User GuideReseller Guide

Email Delivery

Configure managed or self-owned Postmark, Alibaba Cloud DirectMail or custom SMTP, including tests, domain verification and platform fallback.

Edit this page

Email delivery is under Agent Console → Settings, immediately above Balance alert emails. Only the reseller owner can change delivery credentials; sub-admins cannot read or edit them.

Three choices

ServiceWho supplies credentialsBest for
Postmark (recommended)Use the managed service or enter your own Server API TokenHTTPS API delivery from your own domain without relying on SMTP ports
Alibaba Cloud DirectMailThe reseller's sending address and SMTP passwordAn independently managed DirectMail account with a verified domain
Custom SMTPThe reseller's company mailbox or mail-provider credentialsGoogle Workspace, Microsoft 365, Zoho or another SMTP-capable service

Postmark has two modes. The managed mode does not expose platform credentials. Turn managed mode off to enter your own Postmark Server API Token. The platform's Server Token and Account Token are never returned to resellers.

Managed Postmark

  1. Select Managed Postmark and keep the custom sender disabled;
  2. Enter a sending domain you own, such as mail.example.com;
  3. Add the ownership TXT record shown by the console;
  4. Check verification. The platform creates or reuses the Postmark domain and returns DKIM and Return-Path records;
  5. Add those records and check again until the domain is verified;
  6. Use a sender on that exact domain, such as noreply@mail.example.com;
  7. Save and send a test. Check inbox, spam, sender address and display name;
  8. Enable the custom sender only after the test arrives correctly.

If the console says managed domain setup is unavailable, the ModelsOk system administrator must open the main site's System Settings → Operations → Email delivery and configure the Postmark Account Token. This is a platform-operations task, not a reseller permission issue.

Your own Postmark account

  1. Turn off Use platform-managed Postmark;
  2. Copy the Server API Token from Postmark Server → API Tokens and enter it in the reseller console;
  3. Enter the transactional Message Stream ID, normally outbound. Add a Broadcast Message Stream ID if announcements or statement batches will be sent;
  4. Verify the sender domain or Sender Signature in your own Postmark account;
  5. Enter an authorised sender address and display name, save, then send a test;
  6. The token is encrypted at rest. After reload, the console only reports that it is saved and never returns the plaintext.

The Postmark Account Token manages domains for the platform account. It is different from the Server API Token used to send mail, and is not required when using your own account.

Alibaba Cloud DirectMail

  1. Verify a sending domain and create a sending address in DirectMail;
  2. Create a dedicated SMTP password. Do not use the Alibaba Cloud sign-in password or an AccessKey;
  3. Select the same region in the reseller console; the preset uses TLS on port 465;
  4. Use the authorised sending address for both SMTP account and sender;
  5. Save, send a test and enable only after it arrives.

Custom SMTP

Obtain the SMTP host, port, encryption, account and SMTP/App Password from the provider. Port 465 normally uses TLS; ports 25, 587 and 2525 use STARTTLS here. OAuth2-only SMTP accounts are not currently supported.

The sender must be authorised by the provider and should have SPF and DKIM configured. Prefer a dedicated sending account over an employee's personal password.

Testing and fallback

  • Send test email tests only the saved reseller service and always sends to the owner's bound email, so it cannot become an open relay;
  • Accepted means the provider accepted the message, not that it must reach the inbox; check spam too;
  • Unconfigured, disabled or confirmed failures use the platform service, preferring Postmark before platform SMTP;
  • An uncertain network result that may already have been accepted is not retried automatically, preventing duplicates;
  • With a reseller-owned Postmark token, Alibaba Cloud or custom SMTP, security messages such as sign-in codes, email binding and email 2FA remain on the platform channel. Only managed Postmark can send security mail from the reseller domain.

Troubleshooting

SymptomAction
No Postmark token fieldTurn off Use platform-managed Postmark to enter your own Server API Token
Managed Postmark unavailableAsk the ModelsOk system administrator to configure the Account Token
DNS remains unverifiedCheck for a duplicated domain suffix, wait for propagation and keep all verification records
SMTP authentication failsCheck the dedicated password; re-enter it after changing host, port, encryption or account
Test accepted but not receivedCheck the owner's bound address, spam and provider delivery logs

On this page