Signature Request

Update Signature Request

POST
/signature_request/update/{signature_request_id}

Updates the email address and/or the name for a given signer on a signature request. You can listen for the signature_request_email_bounce event on your app or account to detect bounced emails, and respond with this method.

Updating the email address of a signer will generate a new signature_id value.

NOTE: This action cannot be performed on a signature request with an appended signature page.

Authorization

AuthorizationBasic <token>

Your API key can be used to make calls to the Dropbox Sign API. See Authentication for more information. āœ… Supported by Try it console (calls sent in test_mode only).

In: header

Path Parameters

signature_request_id*string

The id of the SignatureRequest to update.

Request Body

application/json

email_address?string

The new email address for the recipient.

This will generate a new signature_id value.

NOTE: Optional if name is provided.

Formatemail
name?string

The new name for the recipient.

NOTE: Optional if email_address is provided.

signature_id*string

The signature ID for the recipient.

expires_at?|

The new time when the signature request will expire. Unsigned signatures will be moved to the expired status, and no longer signable. See Signature Request Expiration Date for details.

Response Body

application/json

application/json

curl -X POST "https://example.com/signature_request/update/fa5c8a0b0f492d768749333ad6fcc214c111e967" \  -H "Content-Type: application/json" \  -d '{    "email_address": "john@example.com",    "signature_id": "2f9781e1a8e2045224d808c153c2e1d3df6f8f2f"  }'
{  "signature_request": {    "signature_request_id": "fa5c8a0b0f492d768749333ad6fcc214c111e967",    "title": "Purchase Agreement",    "subject": "Purchase Agreement",    "message": "Please sign and return.",    "created_at": 1570471067,    "is_complete": true,    "has_error": false,    "custom_fields": [],    "signing_url": null,    "signing_redirect_url": null,    "details_url": "https://app.hellosign.com/home/manage?guid=fa5c8a0b0f492d768749333ad6fcc214c111e967",    "requester_email_address": "me@dropboxsign.com",    "signatures": [      {        "signature_id": "78caf2a1d01cd39cea2bc1cbb340dac3",        "signer_email_address": "danaerys@mereen.gov.ws",        "signer_name": "Danaerys Stormborn",        "signer_role": null,        "order": null,        "status_code": "awaiting_signature",        "signed_at": null,        "last_viewed_at": null,        "last_reminded_at": null,        "has_pin": false,        "has_sms_auth": false      }    ],    "cc_email_addresses": []  }}