In accordance with Piano's Mailing List Health guidelines, ESP Double Opt-In (DOI) is enabled by default across all subscriber workflows. This ensures high-quality user engagement and safeguards long-term mailing list integrity by preventing unintentional or low-quality signups.
In select cases where publishers already manage DOI validation independently, such as through their own email systems, Piano offers a controlled way to bypass our internal DOI verification. This option is only available upon approval and must be enabled by Piano's internal team at the publisher level.
To request DOI deactivation, please contact your Piano Account Manager or the Piano Support Team. Be sure to include your ESP Site ID and a detailed explanation of how DOI is being independently enforced on your side.
Once approved, Piano will enable an internal setting that allows your API calls to include an optional parameter "skipDoiValidation": true. When used, this flag instructs Piano's system to skip DOI checks for that specific API request.
This functionality is supported in the following API endpoints:
-
POST
https://{HOST}/tracker/lucid/sub/{pubid} -
POST
https://{HOST}/tracker/securesub
Body of an example request:
{
"email": "test@example.com",
"sqids": [1, 2, 3, 4, 5],
"skipDoiValidation": true
}
Please note that this setting does not retroactively process users who are already pending DOI. If DOI was active prior to enabling this option, those users will remain unconfirmed. To reprocess and mark them as confirmed, please contact your Piano Account Manager. Any activation events resulting from manual reprocessing will be logged with the reason "manual activation" in ESP Analytics.
This bypass is intended for publishers with robust DOI systems already in place and should not be considered a general workaround.