---
title: "Activate a Signature Request"
method: POST
path: "/signature_requests/{signatureRequestId}/activate"
tags: ["Signature Request"]
---

# Activate a Signature Request

`POST /signature_requests/{signatureRequestId}/activate`

Activates a Signature request, so it is not in `draft` status anymore.
If the `delivery_mode` is not `null`, activating the Signature Request will trigger the notifications to Approvers/Followers/Signers.

## Path parameters

- `signatureRequestId` string, uuid, required — The unique identifier for a resource.

## Request body

- ActivateSignatureRequest
  - `sender_id` string, uuid — The Id of the User that should be considered as the Signature Request sender. They must be part of the Workspace of the Signature Request and be active. Mandatory with `sender_type: "user"`, must be omitted otherwise.

## Response `201`

The Signature Request has been activated

- SignatureRequestActivated
  - `id` string, required
  - `status` 'ongoing' | 'approval', required
  - `name` string, required
  - `delivery_mode` 'email' | 'none', required
  - `created_at` string, date-time, required
  - `activated_at` string, date-time, nullable, required — Timestamp indicating when the Signature Request was activated and made available to its recipients.\ Returns `null` if the Signature Request is still in `draft`.
  - `completed_at` string, date-time, nullable, required — Timestamp indicating when the Signature Request reached the `done` status, i.e. all required Signers have signed and all Approvers have approved.\ Returns `null` if the Signature Request is not yet complete.
  - `approved_at` string, date-time, nullable, required — Timestamp indicating when all Approvers have approved the Signature Request when custom recipient flow is not enabled.\ Returns `null` if no approvers are configured, or if at least one approver has not yet approved, or when `custom_recipient_order` is enabled.
  - `ordered_signers` boolean, required — Enable an ordered workflow, each Signer will be requested to sign in a sequential order
  - `ordered_approvers` boolean, required — Enable an ordered workflow, each Approver will be requested to approve in a sequential order
  - `reminder_settings` SignatureRequestInListReminderSettings, nullable, required
    - `interval_in_days` 1 | 2 | 7 | 14, required
    - `max_occurrences` integer, required
  - `timezone` string, required — Time zone of the dates and times displayed in emails, the Signature Request expiration date, and the PDF Audit Trail. Format: tz database. Default is set to Europe/Paris.
  - `email_custom_note` string, nullable, required
  - `expiration_date` string, date-time, required
  - `signers` EmbeddedSignerWithSignatureLink[], required
    - `id` string, uuid, required
    - `status` 'initiated' | 'notified' | 'verified' | 'processing' | 'consent_given' | 'signed' | 'aborted' | 'error', required
    - `signature_link` string, uri, nullable, required
    - `signature_link_expiration_date` string, date-time, nullable, required
  - `approvers` ApproverToNotify[]
    - `id` string, uuid, required
    - `status` 'initiated' | 'notified' | 'approved' | 'rejected', required
    - `approval_link` string, uri, nullable, required
    - `approval_link_expiration_date` string, date-time, nullable, required
  - `labels` SignatureRequestLabel[] — Labels associated to the Signature Request
    - `id` string, uuid, required — Unique identifier of the Label.
    - `name` string, required — Name of the Label.
  - `documents` SignatureRequestActivatedDocumentsInner[], required
    - `id` string, required
    - `nature` string, required
  - `external_id` string, nullable, required
  - `branding_id` string, uuid, nullable, required
  - `custom_experience_id` string, uuid, nullable, required
  - `audit_trail_locale` 'de' | 'en' | 'es' | 'fr' | 'it' | 'pt' | 'ro', required
  - `signers_allowed_to_decline` boolean, required
  - `rejection_information` SignatureRequestRejectionInformation, nullable, required — Information related to the rejection of a Signature Request by an Approver.
    - `approver_id` string, uuid — Id of the Approver who rejected the Signature Request.
    - `reason` string — Reason provided by the Approver explaining why they rejected the Signature Request.
    - `rejected_at` string, date-time — Timestamp indicating when the Approver rejected the Signature Request.
  - `workflow_session_id` string, uuid, nullable, required — Unique identifier of a Workflow Session. When provided, an Action is created in the Workflow Session, and this resource is associated with that Action.
  - `previous_attempt_id` string, uuid, nullable, required — ID of the previous attempt within the same `workflow_session_id`. Allows continuity between multiple attempts of the same Action. Null if this is the first attempt.
  - `custom_recipient_order` boolean, required — Enable a custom recipients order

## Other responses

- `400` — Bad request
- `401` — Access unauthorized
- `403` — Access forbidden
- `404` — Resource not found
- `405` — This method is not allowed
- `429` — Too Many Requests, please try again later.
- `500` — Internal Server Error

---

[API](https://skmtc.net/yousign/apis/public-api-v3.md) · [All operations](https://skmtc.net/yousign/apis/public-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yousign/public-api-v3/revisions/8d258c0b45d6/schema)