Suppress default Box Sign notifications

Box Sign API allows you to suppress the default Box email notifications sent during the Sign workflow. ​​This feature facilitates the ownership of Box Sign notifications with the following options:

• You can use a fully-customized email notification template to send emails from your domain.
• Apart from emails, you can send push notifications or text messages.​

Using Box Sign API to suppress default notifications

To suppress Box Sign email notifications, you must set the following parameters:

1. Set the suppress_notifications parameter in the signers object to true to turn the notifications off.
2. Set the embed_url_external_user_id parameter to specify the user who will not receive notifications.

This configuration turns off the automatic Box Sign email notifications for a given user. As a result, you can configure and send your own notifications.

curl -i -X POST "https://api.box.com/2.0/sign_requests" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -d '{
       "signers": [
          {    
            "role": "signer",
            "email": "example_email@box.com"
            "suppress_notifications": true
            "embed_url_external_user_id": "1234"
          }
        ],
       "source_files": [
          {
            "type": "file",
            "id": "123456789"
          }
       ],
       "parent_folder": 
          {
            "type": "folder",
            "id": "0987654321"
          }
     }'

Signing Log entries

When Box Sign default notifications are suppressed, the Signing Log will indicate that the sender has suppressed all Box Sign notifications. The log will also provide information on the system used for purposes of notification delivery and the user ID of the signer on your organization’s system, as provided to Box Sign through your API integration.