Bulk Sending

Introduction

The Bulk Sending feature is intended for sending a large number of documents from templates. Document templates are a well-known component in eversign. However, sometimes we want to use one template to generate many documents simultaneously (the bulk of documents).

Bulk sending process is already implemented in eversign UI, but all important endpoints are already exposed in eversign API.

Bulk Sending Process

The bulk sending can be implemented with these steps:

  1. Get Bulk Sending Blank CSV
  2. Validate Bulk Sending CSV
  3. Create Bulk Sending Job
  4. Check the status of the Bulk Sending Job

The first step is to call Get Bulk Sending Blank CSV endpoint will generate CSV template from a specific template. This step is vital because different templates might have various CSV structures. Also, if a particular template is updated, the CSV structure probably changes.

Once a blank CSV template is generated, the next step is to populate this CSV file with data. This data describes bulk sending documents that we want to create from our template.

The next step is to validate if CSV content is correctly provided. For this, we exposed an endpoint to validate bulk sending CSV. Common validations are check if all required fields are present and if data is in the correct format (i.e., email has proper structure).

In the case of failing validation, API will provide a detailed response with validation issues. Once validation issues are resolved, we can proceed to create a bulk sending job.

To be extra safe, the endpoint that creates a bulk sending job will trigger the validation process in the background. This way, if integration does not implement the validation step, API will ensure that validation will occur nevertheless.

The final step is to create a bulk sending job with the provided endpoint.

Important notes

Bulk sending has the potential to enrich the user experience of your integration significantly.

Before implementing it, you should be aware of these constraints.

Hard limits At the moment, there is a hard limit of 250 created documents per single bulk sending job. In the future, as the feature evolves, these limits will increase.
Validation will always occur Validation is crucial for the bulk sending feature. Even if you do not call this endpoint to validate data specifically, the same validation will automatically occur when you create a bulk sending job. Meaning, this validation endpoint is for your convenience to improve user experience in your integration.
Be aware of possible additional costs Be aware of possible additional costsBulk Sending feature is generally used to generate lots of documents. These documents are counted against your API quota, which increases the probability that your quota will be used up. When this happens, the system will check if you have overage allowed. If overages are permitted, the bulk sending job will proceed, and you will be additionally charged for additional API documents.