Skip to main content
New Voice
March 31, 2025
Question

I have a RECIPIENT_LIMIT_EXCEEDED error but only passing one recipient

  • March 31, 2025
  • 2 replies
  • 314 views

Hello everyone, I hope you are all well. I am integrating with Docusign using the PHP SDK in Laravel. Everything was working perfectly until a request came up that I should have 2-factor authentication. I did it via SMS. I was able to send 1 envelope successfully. After that, I am only receiving this error:

"error_code" => "RECIPIENT_LIMIT_EXCEEDED"
"message" => "The recipient limit on the envelope has been exceeded. The cumulative recipient limit has been exceeded."

I am only sending 1 recipient.

A part of my code:

Note: I changed the phone number to an example one but I am passing on the real one.

        $signers = [new Signer([
'email' => $client->email,
'name' => $client->full_name,
'recipient_id' => '1',
'client_user_id' => $client->user_id,
'tabs' => new Tabs(['sign_here_tabs' => $signHereTabs]),
'email_notification' => new SignerEmailNotifications([
'send_email' => false,
'supported_language' => 'pt-BR',
'suppress_emails' => true
]),
'identity_verification' => new RecipientIdentityVerification([
'workflow_id' => $this->workflowId,
'input_options' => [
[
'name' => 'phone_number_list',
'valueType' => 'PhoneNumberList',
'phoneNumberList' => [
[
'countryCode' => '55',
'number' => '44999999999',
]
]
]
]
]),
])];

$envelopeDefinition = new EnvelopeDefinition([
'email_subject' => 'Documentação versa',
'documents' => $documents,
'recipients' => new Recipients(['signers' => $signers]),
'status' => 'sent',
]);

$envelopeApi = new EnvelopesApi($this->apiClient);
$envelopeSummary = $envelopeApi->createEnvelope($this->accountId, $envelopeDefinition);
$envelopeId = $envelopeSummary->getEnvelopeId();


 

One of my questions is, can I authenticate via SMS in a sandbox account?
Thank you.

2 replies

Alexandre.Augusto
Docusign Employee
Docusign Employee
March 31, 2025

Hello, ​@nathanraposo 

 

If sending an envelope using SMS or WhatsApp as the Delivery method you cannot use Phone call/SMS as authentication way.

Details:

Phone Call and SMS identity verification: SMS delivery cannot be used with SMS/phone-based two-factor authentication. Because these methods of verifying identity would send the authentication challenge using the same communication channel as the SMS notification, they would not provide the intended extra level of security. You can still use access code, KBA, or other custom ID solutions to implement recipient authentication.

Article’s details here.

 

I hope that helps, if so, I’d appreciate your Like here.

Best,

Alexandre

Your feedback is very appreciated! You can give a Like and mark this answer as the "Best Answer" for your issue. DocuSign University http://dsucustomers.docusign.com
Docusign Employee
April 1, 2025

The RECIPIENT_LIMIT_EXCEEDED error tracks the total number of recipients you’ve sent to in the past month, not just the single envelope.

If you’re a Docusign customer you may be able to get that recipient limit extended, I would recommend opening up a support case and referencing both your production and demo account IDs.