---
title: "Forward a SignRequest to a different signer by email"
method: POST
path: "/signrequests/{uuid}/forward_signer/"
tags: ["signrequests"]
---

# Forward a SignRequest to a different signer by email

`POST /signrequests/{uuid}/forward_signer/`

## Request body

- ForwardSigner
  - `signer_email_to_forward` string, email, required — Email of the signer that forwards the SignRequest.
  - `signer_email_to_forward_to` string, email, required — Email of the new signer to forward this SignRequest to.
  - `forwarded_reason` string — A reason why this SignRequest is forwarded (optional), this will be visible to all parties involved

## Response `201`

Updated SignRequest instance

- SignRequest
  - `from_email` string, email — Email of user sending the SignRequest (must be a validated email)
  - `from_email_name` string, nullable — Name to be used in the `From` email header, e.g. `{from_email_name} <no-reply@signrequest.com>`
  - `is_being_prepared` boolean, nullable — Have the sender of a SignRequest prepare the document before sending the request out, see: [prepare using the web interface](#section/Preparing-a-document/Prepare-using-the-web-interface)
  - `prepare_url` string, uri
  - `redirect_url` string, uri, nullable — URL at which SignRequest will redirect to when a document is signed
  - `redirect_url_declined` string, uri, nullable — URL at which SignRequest will redirect to when a document is declined
  - `required_attachments` RequiredAttachment[] — Attachments that signers are required to upload
    - `name` string, required
    - `uuid` string
  - `disable_attachments` boolean — Disable uploading/adding of attachments
  - `disable_text_signatures` boolean — Disable usage of signatures generated by typing (text)
  - `disable_text` boolean — Disable adding of text
  - `disable_date` boolean — Disable adding of dates
  - `disable_emails` boolean — Disable all SignRequest status emails as well as the email that contains the signed documents
  - `disable_upload_signatures` boolean — Disable usage of uploaded signatures (images)
  - `force_signature_color` string, nullable — Force specific color for the signature
  - `disable_blockchain_proof` boolean, nullable — Disables storing timestamp proof hashes in blockchain integrations.
  - `text_message_verification_locked` boolean, nullable — When true a text message verification is needed before the signer can see the document
  - `subject` string, nullable — Subject of SignRequest email
  - `message` string, nullable — Message to include in SignRequest email, may contain the following html tags: `a`, `abbr`, `acronym`, `b`, `blockquote`, `code`, `em`, `i`, `ul`, `li`, `ol`, and `strong`
  - `who` 'm' | 'mo' | 'o', nullable — `m`: only me, `mo`: me and others, `o`: only others
  - `send_reminders` boolean — Automatically remind signers to sign a document, see: [automatic reminders](#section/Working-with-a-SignRequest/Automatic-reminders)
  - `signers` Signer[], required
    - `email` string, email, required
    - `display_name` string
    - `first_name` string
    - `last_name` string
    - `email_viewed` boolean
    - `viewed` boolean
    - `signed` boolean
    - `downloaded` boolean
    - `signed_on` string, date-time, nullable
    - `needs_to_sign` boolean — When `false` user does not need to sign, but will receive a copy of the signed document and signing log, see: [Copy only](#section/Additional-signing-methods/Copy-only)
    - `approve_only` boolean — Require user to approve the document (without adding a signature), see: [Approve only](#section/Additional-signing-methods/Approve-only)
    - `notify_only` boolean — Send notifications about the document and a copy of the signed document and signing log, but don't require them to take any action, see: [Notify only](#section/Additional-signing-methods/Notify-only)
    - `in_person` boolean — When used in combination with an embed url on the sender, after sender has signed, they will be redirected to the next `in_person` signer, see: [In person signing](#section/Additional-signing-methods/In-person-signing)
    - `order` integer
    - `language` 'en' | 'en-gb' | 'nl' | 'fr' | 'de' | 'he' | 'da' | 'fi' | 'hu' | 'it' | 'no' | 'pl' | 'pt' | 'es' | 'sv' | 'ru' | 'ja', nullable
    - `force_language` boolean
    - `emailed` boolean
    - `verify_phone_number` string, nullable
    - `verify_bank_account` string, nullable
    - `declined` boolean
    - `declined_on` string, date-time, nullable
    - `forwarded` boolean
    - `forwarded_on` string, date-time, nullable
    - `forwarded_to_email` string, email, nullable
    - `forwarded_reason` string, nullable
    - `message` string, nullable
    - `embed_url_user_id` string, nullable
    - `inputs` SignerInputs[]
      - `type` 's' | 'i' | 'n' | 'd' | 't' | 'c', nullable
      - `page_index` integer, required
      - `text` string
      - `checkbox_value` boolean, nullable
      - `date_value` string, date, nullable
      - `external_id` string, nullable
      - `placeholder_uuid` string, nullable
    - `use_stamp_for_approve_only` boolean, nullable — Place an approval stamp on a document when a signer approves a document
    - `embed_url` string, uri
    - `attachments` SignerAttachment[]
      - `uuid` string
      - `name` string — Defaults to filename
      - `file` string, uri, nullable
      - `for_attachment` RequiredAttachment
        - `name` string, required
        - `uuid` string
    - `redirect_url` string, uri, nullable
    - `redirect_url_declined` string, uri, nullable
    - `after_document` string, uri
    - `integrations` InlineDocumentSignerIntegrationData[]
      - `integration` 'mfiles' | 'salesforce' | 'formdesk' | 'zapier' | 'microsoft-flow', nullable
      - `integration_data` object
    - `password` string — Require the signer to enter this password before signing a document. This field is write only.
  - `uuid` string
  - `url` string, uri
  - `document` string, uri, required
  - `integration` 'mfiles' | 'salesforce' | 'formdesk' | 'zapier' | 'microsoft-flow', nullable
  - `integration_data` object, nullable

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/signrequest/apis/signrequest-api.md) · [All operations](https://skmtc.net/signrequest/apis/signrequest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signrequest/signrequest-api/versions/6bbe20e3fe44/schema)