---
title: "Create/edit signing link for doc group"
method: POST
path: "/v2/document-groups/{document_group_id}/signing-links"
---

# Create/edit signing link for doc group

`POST /v2/document-groups/{document_group_id}/signing-links`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/document-groups/{document_group_id}/signing-links`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/document-groups/:document_group_id/signing-links/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to create a signing link for a document group, or update the existing one.

This endpoint can be used only:
* by the owner of the document group
* when there are no documents within the document group that have Viewers in the routing details
* all the roles specified in the documents are mapped with recipients of the signing link
* when there are no roles with Viewer level of access to all documents
* at least one of the documents has active fields

## Response `200`

The signing link was created or updated.

- object
  - `data` object: Signing link.
    - `id` string: ID of the signing link.
    - `url` string: Full signing link.
    - `hash` string: Short code of the signing link.
    - `created` integer: Unix timestamp of when the link was created.
    - `short_url` string: Short signing link.
    - `json_attributes` object: Additional settings of the link.
      - `brand_id` string: ID of the brand applied to the signing session. `null` if none.
      - `recipients` object: Recipient settings of the link. `null` if none.

## Other responses

- `400`: * Request without headers. * There are no fields on the documents. * Document group has active invite. * There is no recipient on the document group. * There is no guest signer on the first signing step. * There is more than one guest signer on the document group. * Documents should not be deleted. * Not all signers mapped to recipients. * There cannot exist view only recipient on the document group. * `Require Login to Sign` organization setting is enabled. * `Invites Must Use Two Factor Authentication` organization setting is enabled. * At least one recipient contain email group.
- `403`: Current user is not document group owner.

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)