Update Domain Settings

Update a domain's tracking settings.

PATCHhttps://api.maileroo.com/v1/domains/:domain_id/settings

Update a domain's tracking settings. All fields are optional — only the fields you include will be updated.

Scope: domains.settings.write

Path Parameters

domain_idintegerrequired

The ID of the domain.

interaction_trackingbooleanoptional

Optional. Enable or disable open/click tracking.

custom_hostname_trackingbooleanoptional

Optional. Enable custom hostname tracking. Requires a paid plan.

return_pathstringoptional

Optional. Return-path local part. Maximum 24 characters.

Request

PATCH https://api.maileroo.com/v1/domains/123/settings
Content-Type: application/json

{
  "interaction_tracking": true,
  "return_path": "bounces"
}

Returns the updated domain settings object (same shape as Get Domain Settings).

Returns 403 if custom_hostname_tracking is enabled on a non-paid plan.