Skip to main content
Question

I have a RECIPIENT_LIMIT_EXCEEDED error but only passing one recipient


Forum|alt.badge.img

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
Forum|alt.badge.img+14

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


Forum|alt.badge.img+1
  • Docusign Employee
  • 5 replies
  • 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.