Home
Developers
Features
API for eSignature Solutions
Use signNow Electronic Signature API to Merge documents

Use signNow Electronic Signature API to Merge documents

Prefill documents with information from your database using the signNow API. Make the process of filling smooth, easy, and convenient for all participants.

Java

Copy

public class ResponseDocumentFieldsModel
    {
        public ResponseDocumentField[] fields { get; set; }
        public object[] signatures { get; set; }
        public object[] texts { get; set; }
        public object[] checks { get; set; }
        public object[] radiobuttons { get; set; }
        public object[] attachments { get; set; }
        public Enumeration_Options[] enumeration_options { get; set; }
    }

public class Enumeration_Options
    {
        public string id { get; set; }
        public string enumeration_id { get; set; }
        public string data { get; set; }
        public string created { get; set; }
        public string updated { get; set; }
        public string json_attributes { get; set; }
    }
    public class ResponseDocumentField
    {
        public string id { get; set; }
        public string type { get; set; }
        public string role_id { get; set; }
        public ResponseJson_Attributes json_attributes { get; set; }
        public string role { get; set; }
        public string originator { get; set; }
        public string fulfiller { get; set; }
        public string field_request_id { get; set; }
        public string element_id { get; set; }
        public object field_request_canceled { get; set; }
        public string template_field_id { get; set; }
        public string field_id { get; set; }
        public Radio[] radio { get; set; }
    }
    public class ResponseJson_Attributes
    {
        public int page_number { get; set; }
        public int x { get; set; }
        public int y { get; set; }
        public int width { get; set; }
        public int height { get; set; }
        public bool required { get; set; }
        public string label { get; set; }
        public object prefilled_text { get; set; }
        public string custom_defined_option { get; set; }
        public string name { get; set; }
        public dynamic calculation_formula { get; set; }
        public string formula { get; set; }
        public bool italic { get; set; }
        public bool bold { get; set; }
        public int calculation_precision { get; set; }
        public string validator_id { get; set; }
        public int size { get; set; }
        public string font { get; set; }
        public int line_height { get; set; }
    }
    public class RequestUpdateFieldValueModel
    {
        public object[] texts { get; set; }
        public object[] signatures { get; set; }
        public object[] checks { get; set; }
        public object[] radiobuttons { get; set; }
        public object[] attachments { get; set; }
        public List<RequestFieldModel> fields { get; set; }
        public int client_timestamp { get; set; }
    }
    public class RequestFieldModel
    {
        public int page_number { get; set; }
        public string role { get; set; }
        public string type { get; set; }
        public string name { get; set; }
        public bool required { get; set; }
        public int width { get; set; }
        public int height { get; set; }
        public int x { get; set; }
        public int y { get; set; }
        public object prefilled_text { get; set; }
        public string label { get; set; }
        public bool bold { get; set; }
        public bool underline { get; set; }
        public string align { get; set; }
        public string valign { get; set; }
        public string arrangement { get; set; }
        public int max_chars { get; set; }
        public int max_lines { get; set; }
        public string font { get; set; }
        public int size { get; set; }
        public bool custom_defined_option { get; set; }
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public Radio[] radio { get; set; }
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public IEnumerable<string> enumeration_options { get; set; }
        public object calculation_formula { get; set; }
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public int calculation_precision { get; set; }
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public bool italic { get; set; }
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public string formula { get; set; }
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public float line_height { get; set; }
    }
public partial class RestSharpSamples
    {
        /// <summary>
        /// Get Set prefilled values based on field unique name.
        /// </summary>
        public static void SetTemplateInitialValues(string accessToken, string apiUrl, string templateId, Dictionary<string,object> fieldValue)
        {
            if (!fieldValue.Any())
            {
                return;
            }
            var client = new RestClient { BaseUrl = new Uri(apiUrl) };

var request = new RestRequest($"/document/{templateId}", Method.GET)
                .AddHeader("Accept", "application/json")
                .AddHeader("Authorization", $"Bearer {accessToken}");

var response = client.Execute(request);

if (response.StatusCode != HttpStatusCode.OK)
            {
                throw new Exception(response.Content);
            }
            var documentResponse = JsonConvert.DeserializeObject<ResponseDocumentFieldsModel>(response.Content);
            var fieldUpdateRequest = new List<RequestFieldModel>();
            foreach (var field in documentResponse.fields)
            {
                var foundField = fieldValue.FirstOrDefault(e => e.Key.Equals(field.json_attributes.name));
                if (foundField.Value != null)
                {
                    field.json_attributes.prefilled_text = foundField.Value;
                }

var customDefValue = field.json_attributes.custom_defined_option == "1" ? true : false;

var fieldModel = new RequestFieldModel
                {
                    height = field.json_attributes.height,
                    label = field.json_attributes.label,
                    name = field.json_attributes.name,
                    page_number = field.json_attributes.page_number,
                    prefilled_text = field.json_attributes.prefilled_text,
                    required = field.json_attributes.required,
                    role = field.role,
                    width = field.json_attributes.width,
                    x = field.json_attributes.x,
                    y = field.json_attributes.y,
                    font = field.json_attributes.font,
                    formula = field.json_attributes.formula,
                    bold = field.json_attributes.bold,
                    calculation_formula = field.json_attributes.calculation_formula,
                    calculation_precision = field.json_attributes.calculation_precision,
                    italic = field.json_attributes.italic,
                    line_height = field.json_attributes.line_height,
                    custom_defined_option = customDefValue,
                    type = field.type,
                    size = field.json_attributes.size,
                    radio = field.radio                   
                };
                if (field.type == "enumeration")
                {
                    fieldModel.enumeration_options = documentResponse.enumeration_options.Where(e => e.id == field.id).Select(e => e.data);
                }
                fieldUpdateRequest.Add(fieldModel);
            }

var updateField = new RequestUpdateFieldValueModel {
                checks = documentResponse.checks,
                attachments = documentResponse.attachments,
                radiobuttons = documentResponse.radiobuttons,
                signatures = documentResponse.signatures,
                texts = documentResponse.texts,
                fields = fieldUpdateRequest
            };

var documentUpdateRequest = new RestRequest($"/document/{templateId}", Method.PUT)
                .AddHeader("Accept", "application/json")
                .AddHeader("Authorization", $"Bearer {accessToken}");

documentUpdateRequest.RequestFormat = DataFormat.Json;
            documentUpdateRequest.AddBody(updateField);

var updateResponse = client.Execute(documentUpdateRequest);
            if (response.StatusCode != HttpStatusCode.OK)
            {
                throw new Exception("Updating field values failed: " + updateResponse.Content);
            }
        }
    }
}

View full API reference

Let your signers either leave pre-filled text as it is or replace it with some other topical data.

Save time for your recipients and minimize their task by filling a document with the information you already have.

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

API Documentation

Learn how to get started with the signNow REST API, check out common API use cases, signNow SDKs and code samples.

See documentation

API Pricing

Once you’ve tested the signNow API in sandbox, choose the API subscription plan that best suits your business needs.

See pricing

Make your first API call in a few easy steps

Our developer-friendly API has everything you need to get started right away

REST Endpoints API

Quickly embed eSignatures into your website or app using signNow REST API calls.

Learn more

Three-Legged Oauth

Make your signature requests secure and easy to sign using the three-legged OAuth process.

Learn more

SOAP Services

Check out which SOAP services are supported by the signNow API.

Learn more

Common Use Cases

We’ve prepared some ready-made scenarios for your document workflows.

Learn more

Start using the signNow API with any of our SDKs

Get started with uninterrupted eSignature API: use signNow Electronic Signature API to Merge documents

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 use signNow Electronic Signature API to Merge documents.

Use signNow Electronic Signature API to Merge documents 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, examine, and operate (no sales people involved). Get the capability to use signNow Electronic Signature API to Merge documents conveniently. Choose signNow for more optimized eSignature workflows.

How it works

Create an account and get the required tokens

Use code samples to use signNow Electronic Signature API to Merge documents

Enjoy the power of eSignature in your workflows

API

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.

Amazing & Efficent

Katya E

What do you like best?

My favorite part of this software is how easy it is to use. I can input where I need signatures, initials, dates or text on all of the documentation so easily, and I have not had one client ask how to use it or sign it, and my clients age from 23-65. It is so user friendly and makes my business run more efficiently than ever.

Read full review

Easy to use

User

What do you like best?

SignNow is simple to use and does everything I need. I've used it for both business and personal applications and have been satisfied overall. I've never had an issue with prospects receiving documents and the format has always turned out looking the way I expected.

Read full review

Easy to use and less expensive than competitiors

Chris A

What do you like best?

The interface is very easy to use, it is less expensive than the competition, and I don't use it every day, so it's not a service I am willing to shell out a ton on as far as a monthly fee. SignNow is fair.

Read full review