Bulk

Create Bulk Campaign

Create a bulk campaign with recipients provided directly as JSON (no Excel upload needed for API clients). Each recipient generates one individualized sign request, merged from the bulk template. Invalid rows (missing fields, invalid email, duplicate email) are skipped and reported in skipped_recipients, not fatal.

post/bulk-campaigns

Request

  • Base URL: https://www.jurisign.fr/api/v1
  • URL: https://www.jurisign.fr/api/v1/bulk-campaigns
  • Auth: HTTP bearer

Request body

namestring required
bulk_template_idstring uuid required
expiry_hoursinteger required
otp_channel'sms' | 'email' required
messagestring nullable
require_selfieboolean
identity_verificationboolean

Paid option "Signer identity verification", same rules as on POST /sign-requests: ignored when the option is not available to your organization; outside the sandbox, refused with 422 (errors.identity_verification) when your available identity credits do not cover every recipient (one signer each). The signature remains a simple electronic signature (SES): the verification strengthens the evidence file, it is neither an advanced nor a qualified signature.

sender_namestring nullable

Name shown to signers as the sender for this request, e.g. your own customer when you sign on their behalf. Displayed as "<sender_name>, via <your organization name>" in the invitation e-mail and on the signing page, and recorded in the evidence file. No URL or HTML. Omit it to keep the default sender name. Applied to every request of the campaign.

remindersboolean

Automatic e-mail reminders to signers (D+1, D+3, D+5 and the day before expiry). Set to false to disable them for this request, e.g. when your system sends its own reminders (see POST /sign-requests/{id}/remind). Applied to every request of the campaign.

redirect_urlstring uri nullable

Must use https and match the domain declared for your organization, or the request is rejected with a 422. Contact support to register your domain. Why a declared domain: the signer trusts the jurisign.fr link; accepting any URL would let anyone bounce your signers to a lookalike phishing site (open redirect). Your subdomains are accepted automatically; do not declare an IP, localhost or a shared hosting domain. Omit redirect_url while testing. See https://www.jurisign.fr/api/guide#redirection Applied to every request of the campaign.

requires_paraphboolean

Initials on every page: each signer draws initials distinct from the signature, stamped at the bottom of every page (the full signature goes in the signature zones). Not restricted by plan on the API. Applied to every request of the campaign.

require_geolocationboolean

Record where each signer signs: the position declared by the signer's device (with its accuracy) and a fingerprint of the device, written to the proof (the signer consents first). Never rejected: included from the Professionnel plan; otherwise billed 1.25 EUR excl. VAT per request on the monthly invoice (or one prepaid 'lieu de signature' credit is used). Never billed in the sandbox. Applied to every request of the campaign.

Example request

{
  "redirect_url": "https://app.your-company.com/signed"
}

Response

Campaign created (draft, not yet launched)

skipped_recipientsinteger

Changes

No recorded changes to this operation across all 1 revision of this API.