Skip to content

Add agentmail.to hosted-email template - #1600

Open
RoboboCode wants to merge 3 commits into
Domain-Connect:masterfrom
RoboboCode:add-agentmail-hosted-email-template
Open

Add agentmail.to hosted-email template#1600
RoboboCode wants to merge 3 commits into
Domain-Connect:masterfrom
RoboboCode:add-agentmail-hosted-email-template

Conversation

@RoboboCode

@RoboboCode RoboboCode commented Aug 16, 2026

Copy link
Copy Markdown

Description

New Domain Connect template for AgentMail hosted email (providerId agentmail.to, serviceId hosted-email). It configures the records a domain needs to send and receive mail through AgentMail: root MX, an MX for the fixed mail subdomain, a DKIM TXT record (agentmail._domainkey), an SPF merge (SPFM) on mail, and a static DMARC record.

Type of change

Please mark options that are relevant.

  • New template
  • Bug fix (non-breaking change which fixes an issue in the template)
  • New feature (non-breaking change which adds functionality to the template)
  • Breaking change (fix or feature that would cause existing template behavior to be not backward compatible)

How Has This Been Tested?

Please mark the following checks done

  • Template functionality checked using Online Editor
  • Template file name follows the pattern <providerId>.<serviceId>.json
  • resource URL provided with logoUrl is actually served by a webserver

Checklist of common problems

Mark all the checkboxes after conducting the check. Comment on any point which is not fulfilled.
See Template Quality Guidelines for details and rationale on each rule.

  • syncPubKeyDomain is set — this is mandatory; omitting it requires explicit justification in the PR description or the PR will be rejected
  • warnPhishing is not set alongside syncPubKeyDomain — the two must not appear together
  • syncRedirectDomain is set whenever the template uses redirect_uri in the synchronous flow
  • no TXT record contains SPF content ("v=spf1 ...") — use the SPFM record type instead
  • txtConflictMatchingMode is set on every TXT record that must be unique per label or content prefix (e.g. DMARC)
  • no variable is used as a bare full record value (e.g. @ TXT "%foo%") unless necessary — prefer @ TXT "service-foo=%foo%"; if bare, justify in the PR description
  • no bare variable is used as the full host label — the non-variable parts are fixed to limit misuse (e.g. %dkimkey%._domainkey, not %dkimhost%); if bare, justify in the PR description
  • no variable is used in the host field to create a subdomain — use the host parameter or multiInstance instead
  • %host% does not appear explicitly in any host attribute
  • essential is set to OnApply on records the end user may need to modify or remove without breaking the template (e.g. DMARC)

Notes:

  • All record hosts are fixed strings (@, mail, agentmail._domainkey, _dmarc); only record values travel as variables. The DKIM value is constrained to the key payload ("v=DKIM1; k=rsa; p=%dkimp%").
  • MX targets/priorities are variables because AgentMail's inbound/outbound endpoints are region-dependent per account; the DKIM key is per-domain.
  • The DMARC record is fully static (rua=mailto:dmarc@%domain% uses only the protocol-provided %domain%) and carries txtConflictMatchingMode: Prefix + essential: OnApply.

Online Editor test results

Editor test link(s):

@github-actions github-actions Bot added Checklist of common problems not complete See PR template and mark *all* checkboxes, even if not applicable. Explain any discrepancies. no syncPubKeyDomain syncPubKeyDomain not set. Template is not secured. PR description incomplete The PR description template was not filled in at all, altered or filled in improperly. warnPhishing warnPhishing is set. Template is not secured. Test links missing No test links from Online Editor provided labels Aug 16, 2026
@github-actions

Copy link
Copy Markdown

JSON Filename Check Passed

@github-actions

github-actions Bot commented Aug 16, 2026

Copy link
Copy Markdown

JSON Schema Validation Passed

@github-actions github-actions Bot added the schema-error JSON Schema validation failed label Aug 16, 2026
@github-actions

github-actions Bot commented Aug 16, 2026

Copy link
Copy Markdown

Linter OK

agentmail.to.hosted-email.json

Level Code Note
info DCTL1031 all record groupId values are the same

@github-actions github-actions Bot removed no syncPubKeyDomain syncPubKeyDomain not set. Template is not secured. warnPhishing warnPhishing is set. Template is not secured. labels Aug 16, 2026
@github-actions github-actions Bot removed schema-error JSON Schema validation failed Checklist of common problems not complete See PR template and mark *all* checkboxes, even if not applicable. Explain any discrepancies. PR description incomplete The PR description template was not filled in at all, altered or filled in improperly. Test links missing No test links from Online Editor provided labels Aug 16, 2026
@github-actions

Copy link
Copy Markdown

PR Description Check Passed

All required sections are filled in correctly.

Details
  OK  Type of change: 1/4 checkboxes ticked
  OK  How Has This Been Tested?: all 3 checkboxes ticked
  OK  Checklist of common problems: 10/10 checkboxes ticked
  OK  Online Editor test results: 2 link(s) found
  OK  Template coverage: all 1 template(s) covered
Labels to remove: Checklist of common problems not complete, Forged editor links, PR description incomplete, Test links missing

PR description check PASSED

"groupId": "a",
"type": "MX",
"host": "@",
"pointsTo": "%mxtarget%",

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Observe other templates which don't use bare host for this solution:

https://github.com/search?q=repo%3ADomain-Connect%2FTemplates+amazonaws.com&type=code

"groupId": "a",
"type": "MX",
"host": "mail",
"pointsTo": "%mxtargetmail%",

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same here

@github-actions github-actions Bot added the review issues Changes requested from PR review label Aug 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

review issues Changes requested from PR review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants