I'm working on a DocuSign integration using the eSignature API (sandbox environment) and I need to configure BCC email settings on envelopes using the email_settings.bccEmailAddresses
field.
The request works perfectly in the API Explorer:
https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopeemailsettings/create/?explorer=true
However, when I try the same request from my Ruby application (using the official SDK), I get this error only when bccEmailAddresses
is included:
{
"errorCode": "API_REQUEST_IS_FORBIDDEN",
"message": "The API request is forbidden. Request blocked due to excess usage"
}
HTTP status: 444
Without the email_settings
, the envelope is created successfully.
I also tried to set email_settings
during the create_envelope
call, but it did not work — the field is either ignored or causes the same error depending on how it's passed. Even when correctly structured (and working in the API Explorer), it fails in the application context.
Details:
-
SDK:
docusign_esign 5.2.0
-
The authenticated user is an admin and has
canManageAccount
permission -
OAuth2 is via JWT impersonation
-
Envelope status is
"created"
-
Endpoint used:
POST /v2.1/accounts/{account_id}/envelopes
POST /v2.1/accounts/{account_id}/envelopes/{envelope_id}/email_settingsAfter some research, I suspect that BCC Email Archive is not enabled for my sandbox account, which may be the root cause of the 444 error.
Could someone confirm whether this feature needs to be manually enabled in sandbox?