Skip to main content
After you create a sign request, each signer needs a way to open the request. You can:
  • Let Box email the signer, and optionally customize the subject and body
  • Turn off Box email and send the signing link yourself
  • Embed the signing client in your website
Set these options when you create the request. You cannot change them when you cancel a request.

​
Customize Box email

By default, Box Sign emails each signer from a box.com address with a generic subject and body. Set email_subject and email_message when you create the request to change that copy. Both accept strings. email_message also accepts the following HTML tags: a, abbr, acronym, b, blockquote, code, em, i, ul, li, ol, strong. Custom styles are not allowed. A high text-to-HTML ratio can send the email to spam or cause clipping. If you create the request from a template, the template can already define the subject and body. Set are_reminders_enabled to true to email unsigned signers after 3, 8, 13, and 18 days. To resend immediately, see Resend a Box Sign request.

​
Send your own notifications

To take over delivery, set both of these on the signer when you create the request:
  1. suppress_notifications to true
  2. embed_url_external_user_id to an ID you choose for that person
Box Sign then skips the default signing email for that signer. The response includes embed_url, which you can put in your own email, push notification, or text message. You can send the notice from your own domain and use any channel you already operate. The signing log records that you suppressed Box notifications and stores the signer ID you passed in embed_url_external_user_id.
When you suppress Box email, your organization is responsible for delivering every required notice to signers at the right time, with the right content, and in line with applicable law, including consent to the delivery method when that applies.
A simplified response includes both the embed_url and iframeable_embed_url for that signer:
Use embed_url in your own notification. Use iframeable_embed_url to embed the client, as described next.

​
Embed the signing client

Box Embed lets signers complete the request inside your website, instead of leaving for Box Sign and coming back. Pass embed_url_external_user_id for each signer when you create the request. The response includes a unique iframeable_embed_url for that signer:
Put that URL in an iframe:
For in-person signing on the requester’s device, also set is_in_person to true. For more information, see In-person signing. For more information on Box Embed, see Embed Box elements programmatically.
Last modified on September 18, 2026