Skip to content

[EN-145] Document custom tracking domains - #548

Open
quzhi1 wants to merge 1 commit into
mainfrom
codex/en-145-custom-tracking-domains
Open

[EN-145] Document custom tracking domains#548
quzhi1 wants to merge 1 commit into
mainfrom
codex/en-145-custom-tracking-domains

Conversation

@quzhi1

@quzhi1 quzhi1 commented Aug 3, 2026

Copy link
Copy Markdown

Description

Summary

  • Document the existing tracking_options.domain_name hash contract for regular Send.
  • Add Transactional Send, draft create/update, and scheduled-send examples.
  • Clarify that a Transactional sender domain is distinct from the custom tracking hostname.
  • Add request-forwarding and JSON-shape regression coverage.
  • Add an unreleased changelog entry linking to the public message-tracking guide.

Why

Implements EN-145. The Ruby SDK already forwards hash-based request bodies, so custom tracking hostnames need documented request shapes and regression coverage rather than a new typed model.

Developer impact

Ruby callers can pass an active organization-owned hostname as tracking_options.domain_name alongside links and/or opens. Requests that omit the field remain unchanged and continue using the default Nylas tracking hostname.

The examples also document draft inheritance, scheduled-send revalidation, and the distinction between the Transactional Send route's sender domain and the body field's tracking hostname.

Validation

  • bundle exec rspec spec - 315 examples, 0 failures
  • bundle exec rubocop --config .rubocop.yml - 80 files, no offenses
  • bundle exec yard doc --no-output - succeeds
  • git diff --check - clean

License

I confirm that this contribution is made under the terms of the MIT license and that I have the authority necessary to make this contribution on behalf of its copyright owner.

@quzhi1
quzhi1 marked this pull request as ready for review August 3, 2026 20:31
@quzhi1
quzhi1 requested a review from AaronDDM August 3, 2026 20:31
@quzhi1 quzhi1 self-assigned this Aug 3, 2026
@quzhi1
quzhi1 requested review from googsvg and radenkovic August 3, 2026 20:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant