Electronic Signature
Developers
Features
API for eSignature Solutions
Create a Document Group for templates to sign using API

Create a Document Group for templates to sign using API

Create a document group from a list of templates IDs. Users can invite one signer to eSign several documents or send certain documents in the group to different signers within one application.

Free to test
Fast to deploy
Powerful & secure

Organize templates in groups for faster approval

Use the sample code to organize several templates in a group and send them out in bulk to one or multiple signers.

Node.js

C#

cURL

Copy code

'use strict';
 
const signnow = require('@signnow/api-client')({
  credentials: 'BASE64_ENCODED_CLIENT_CREDENTIALS',
  production: true, // if false then uses eval server
});
const createDocumentGroupTemplate = signnow.documentGroupTemplate.create;
 
const token = 'YOUR_ACCESS_TOKEN';
const template_group_name = 'NAME_OF_NEW_DOCUMENT_GROUP_TEMPLATE';
const template_ids = [
  'TEMPLATE_1_ID',
  'TEMPLATE_2_ID',
 
  // ...
];
 
/**
 * see API Reference for routing details configuration info
 * at https://signnow.github.io/SignNowNodeSDK/class/lib/documentGroupTemplate.js~DocumentGroupTemplate.html#static-method-create
 */
const routing_details = {
  invite_steps: [
    {
      order: 1,
      invite_emails: [
        {
          email: 'Email of Signer 1',
          subject: 'Signer 1 Needs Your Signature',
          message: 'Signer 1 invited you to sign Document 1',
          expiration_days: 30,
          reminder: 0,
          hasSignActions: true,
          allow_reassign: '0',
        },
      ],
      invite_actions: [
        {
          email: 'Email of Signer 1',
          role_name: 'Signer 1',
          action: 'sign',
          document_id: 'TEMPLATE_1_ID',
          document_name: 'Document 1',
          role_viewName: 'Signer 1',
          allow_reassign: '0',
          decline_by_signature: '0',
        },
      ],
    },
    {
      order: 2,
      invite_emails: [
        {
          email: 'Email of Signer 2',
          subject: 'Signer 2 Needs Your Signature',
          message: 'Signer 2 invited you to sign Document 2',
          expiration_days: 30,
          reminder: 0,
          hasSignActions: true,
          allow_reassign: '0',
        },
      ],
      invite_actions: [
        {
          email: 'Email of Signer 2',
          role_name: 'Signer 2',
          action: 'sign',
          document_id: 'TEMPLATE_2_ID',
          document_name: 'Document 2',
          role_viewName: 'Signer 2',
          allow_reassign: '0',
          decline_by_signature: '0',
        },
      ],
    },
  ],
  include_email_attachments: 0,
};
 
/**
 * @param {Object} res
 * @param {string} res.id - id of created document group template
 */
const handleResponse = res => {
  console.log(res);
};
 
const handleError = err => {
  console.error(err);
};
 
createDocumentGroupTemplate({
  template_group_name,
  template_ids,
  routing_details,
  token,
}, (err, res) => {
  if (err) {
    handleError(err);
  } else {
    handleResponse(res);
  }
});

public class DocumentGroupSendInviteModel
    {
        public IEnumerable<InviteSteps> invite_steps { get; set; }
        public IEnumerable<CompletionEmails> completion_emails { get; set; }
    }
 
    public class InviteSteps
    {
        public int order { get; set; }
        public IEnumerable<InviteEmails> invite_emails { get; set; }
        public IEnumerable<InviteActions> invite_actions { get; set; }
    }
 
    public class InviteEmails
    {
        public string email { get; set; }
        public int disabled { get; set; }
        public string subject { get; set; }
        public string message { get; set; }
    }
 
    public class InviteActions
    {
        public string email { get; set; }
        public string role_name { get; set; }
        public string action { get; set; }
        public string document_id { get; set; }
        public int allow_reassign { get; set; }
        public Authentication authentication { get; set; }
    }
 
    public class Authentication
    {
        public string type { get; set; }
        public string value { get; set; }
    }
 
    public class CompletionEmails
    {
        public string email { get; set; }
        public int disabled { get; set; }
        public string subject { get; set; }
        public string message { get; set; }
    }
 
    public enum DocumentGroupAction
    {
        sign,
        view
    }
public class CreateResponseModel
    {
        public string id { get; set; }
    }
public partial class RestSharpSamples
    {
        public static CreateResponseModel DocumentGroupSendInvites(string apiUrl, string accessToken, string groupId, DocumentGroupSendInviteModel invites)
        {
            var client = new RestClient { BaseUrl = new Uri(apiUrl) };
 
            var request = new RestRequest($"/documentgroup/{groupId}/groupinvite", Method.POST)
                .AddHeader("Accept", "application/json")
                .AddHeader("Authorization", $"Bearer {accessToken}");
 
            request.RequestFormat = DataFormat.Json;
            request.AddBody(invites);
            var response = client.Execute(request);
 
            if (response.StatusCode != HttpStatusCode.OK)
            {
                throw new Exception(response.Content);
            }
 
            return JsonConvert.DeserializeObject<CreateResponseModel>(response.Content);
        }
    }

curl -X POST \
  http://{{url}}/documentgroup/{{document_group_id}}/groupinvite \
  -H 'Authorization: Bearer {bearer_token}' \
  -H 'Content-Type: application/json' \
  -d '{
   "invite_steps":[
      {
         "order": 1,
         "invite_emails":[
            {
               "email":"{{step1_email}}",
               "subject":"custom subject",
               "message":"custom message"
            }
         ],
         "invite_actions":[
            {
               "email":"{{step1_email}}",
               "role_name":"{{role_name}}",
               "action":"sign",
               "document_id":"{{document_id}}"
            }
         ]
      },
      {
        "order": 2,
         "invite_emails":[
            {
               "email":"{{step2_email}}",
               "subject":"custom subject",
               "message":"custom message"           
            }
         ],
         "invite_actions":[
            {
               "email":"{{step1_email}}",
               "role_name":"{{role_name}}",
               "action":"sign",
               "document_id":"{{document_id}}"
            }
         ] 
      }
   ]
}'

We provide developers with complete SDKs for all popular languages, allowing them to integrate eSignature workflows without writing a single line of code.
With our detailed documentation, integrating the signNow API is a breeze.
The signNow API not only provides you with eSignatures: use it to create fillable forms, request payments, and download & archive documents using simple API calls.

View full API reference

signNow regularly wins awards for ease of use and setup

Read our reviews on the trusted resources

Tech Data uses signNow to improve our internal and external customer service while increasing our speed to revenue.

Bob Dutkowsky | CEO

Select an API package for your business

Integrate eSignatures into your software and get 250 legally-binding signature invites with your API free trial.

Check API pricing

Solution engineers

We are here to help you configure eSignature API to your workflow.

Review signNow’s API documentation

The detailed API tutorial will guide you through the entire integration process and provide clear coding examples.

Video guides

Watch our video guides for instructions on how to easily build custom integrations.

Start with any of our SDKs

Get complete SDKs for Node.js, Python,
PHP, Java, C#.

Enterprise-grade security and compliance

signNow is committed to protecting your sensitive information by complying with global industry-specific security standards.

Learn more

GDPR compliance

Regulates the use and holding of personal data belonging to EU residents.

SOC 2 Type II Certified

Guarantees the security of your data & the privacy of your clients.

PCI DSS certification

Safeguards credit/debit card data for every monetary transaction a customer makes.

21 CFR Part 11

FDA-backed standards for electronic documentation and electronic signatures.

HIPAA compliance

Protects the private health information of your patients.

CCPA compliance

Enhances the protection of personal data and the privacy of California residents.

Watch the signNow API in action

Get started with uninterrupted eSignature API: create a Document Group for templates to sign using API

Consolidate and streamline your eSignature workflows and establish seamless processes. Try the signNow API, implement eSignature workflows into your custom apps and websites in minutes, and seamlessly create a Document Group for templates to sign using API.

Create a Document Group for templates to sign using API the signNow API for uninterrupted eSignature API

Click API on the signNow main page and create your API Sandbox account.
Open your email to confirm the registration and specify a password for accessing your Developer Sandbox environment.
Find the list of your apps at the top of the page. By default, you can also find a Test App for testing the API.
Click its name to access the Client ID and Basic Authorization Token.
Launch the API using the information from the previous step.
Use the code samples from the signNow library.
When you're ready to go live, go to your signNow account and choose a subscription plan.
If you can't find a subscription that suits your needs, contact the Sales team.
Change the test URL in your requests to the production environment URL.
Delight your customers and partners with a streamlined eSignature experience.

The signNow API is straightforward to embed, test, and work with (no vendor engaged). Gain the opportunity to create a Document Group for templates to sign using API conveniently. Choose signNow for more optimized eSignature workflows.

How it works

Create an account and get the required tokens

Use code samples to create a Document Group for templates to sign using API

Enjoy the power of eSignature in your workflows

Watch our instructions to build custom integrations with ease

signNow offers a free testing environment to explore the eSignature.

Trusted eSignature solution — what our customers are saying

Explore how the signNow eSignature platform helps businesses succeed. Hear from real users and what they like most about electronic signing.

using it for a year and works very good for our startup

5

Administrator in Computer Hardware

What do you like best?

We are a paperless startup company with 12 employees, we manage everything from employement agreements to tax reporting using SignNow. Works great for us, specially the template function.

Read full review

Great product. Great price!

5

Administrator in Entertainment

What do you like best?

I like the price best -- it makes a great product affordable for me as a freelancer.

Read full review

Excellent Time saving experience

5

Administrator in Real Estate

What do you like best?

Ease of use of interface - there is no question at what stage each document is at.