Docs

Sending Domains

PUT

Update Sending Domain

PUT /v1/domains/{domainId}

Update settings for an existing sending domain.

Use Cases:

  • Enable or disable open tracking
  • Enable or disable click tracking
  • Toggle DMARC enforcement
  • Adjust tracking settings after initial setup

Behavior:

  • Only provided fields are updated (partial updates supported)
  • Domain name cannot be changed (create a new domain instead)
  • DNS records are not affected by updates
  • Returns the complete updated domain object

Required Scope: update:domains

Updatable Fields:

  • openTrackingEnabled: Track email opens via invisible pixel
  • clickTrackingEnabled: Track link clicks via redirect URLs
  • dmarcEnabled: Enable DMARC alignment for the domain

Note: Changing tracking settings takes effect for new emails only. Existing sent emails are not affected.

Path parameters

domainIdstringrequired

Sending domain ID

Bodyrequired

openTrackingEnabledboolean
clickTrackingEnabledboolean
dmarcEnabledboolean
inboxEnabledboolean

Response

200Sending domain updated successfully with refreshed settings
objectstringrequired
idstringrequired
namestringrequired
dkimVerifiedbooleanrequired
returnPathVerifiedbooleanrequired
trackingVerifiedbooleanrequired
openTrackingEnabledbooleanrequired
clickTrackingEnabledbooleanrequired
dnsRecordsobjectrequired
createdAtstringrequired
sslStatusanyrequired
sslErroranyrequired
Copyright © 2026 Kibamail.·Privacy Policy