---
title: "Create link for doc group"
method: POST
path: "/v2/document-groups/{document_group_id}/embedded-editor"
---

# Create link for doc group

`POST /v2/document-groups/{document_group_id}/embedded-editor`

## Request

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

This endpoint allows API users to generate a link to embed the SignNow editor into their app, allowing their customers to edit documents without sending them for signing.

To generate an embedded editor link, make sure that:

- the document group has not been sent for signing or signed.
- the document group is not deleted or archived.

## Request body

- object
  - `redirect_uri` string: Optional: link that opens after the user has completed editing the document group.
  - `link_expiration` integer: 15 minutes by default. Can be set max to 43200 minutes by a user with Admin level of access.
  - `redirect_target` string: Determines whether to open the redirect link in the new tab in the browser, or in the same tab after the signing session. Possible values: `blank` - opens the link in the new tab, `self` - opens the link in the same tab, default value.

## Response `200`

Link to the document group in the embedded editor.

- object
  - `data` object: Embedded editor link.
    - `url` string: URL that opens the document group in the editor. The URL contains an access token and expires after `link_expiration` minutes.

## Other responses

- `400`: * Incorrect or missing token. * Document group was already sent. * Document group not found. **Validation errors:** * `redirect_uri` is not a string. * Empty `redirect_uri`. * `redirect_uri` is longer than 2048 characters. * `redirect_uri` is not a correct URL. * `link_expiration` is not an integer. * `link_expiration` must be between 15 and 45. * Custom `link_expiration` is more than 43200 minutes. * `redirect_target` is not a string. * Incorrect `redirect_target`. Allowed values: `self`, `blank`. * `redirect_uri` is required if `redirect_target` is added.
- `403`: User doesn't own the document group.

---

[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)