TL;DR: Send a template signature request by both email and SMS with one API call. Set the role’s
deliveryModetoEmailAndSMSand add the signer’s phone number. The signer gets the same link in the inbox and on the phone. Our page on SMS signature requests explains the feature.
You send the same offer letter to every new hire, so it lives in a template. Some hires read email at once, and others only check their phone. A request sent to one channel alone can sit unsigned for days.
Sending through both channels fixes that. This guide shows the fields to set and the code for six languages.
How does an email signature API integration add SMS?
An email signature API integration sends the signing link by email by default. Add a phone number and one delivery setting, and the same request also goes out by text.
Think of a parcel service that both emails and texts you when a delivery is due. You see the notice on whichever screen you check first. Email and SMS delivery for a signature request works the same way.
Which fields send a template request by email and SMS?
Set deliveryMode to EmailAndSMS on each role that should get both messages. Then add a phoneNumber object with the signer’s countryCode and number.
The deliveryMode field takes three values:
Email, which sends the link to the inbox onlySMS, which sends the link by text message onlyEmailAndSMS, which sends the link both ways
Keep the signer’s email address in the role as well. To send by text alone, see how to send eSignature requests through SMS.
How do you send the request in code?
Each sample below sends a document from an existing template to one signer by email and SMS. Swap in your own API key, template ID and phone number.
- Create the template once, in the web app or with the API.
- Build a role with the signer’s name, email,
phoneNumberanddeliveryMode. - Call the send-from-template endpoint with the template ID and the role.
Our help article shows how to create a template using the BoldSign API. The developer guide on how to request a signature by email and SMS from a template covers the same call.
curl -X POST \
"https://api.boldsign.com/v1/template/send?templateId=8fbed3d0-yyyy-xxxx-21f041809b72" \
-H "accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Testing",
"message": "msg",
"roles": [
{
"roleIndex": 1,
"signerName": "Alex",
"signerEmail": "alex@example.com",
"phoneNumber": {
"countryCode": "{Signer’s Country Code}",
"number": "{Signer’s Phone Number}"
},
"deliveryMode": "EmailAndSMS",
"signerType": "Signer",
"signerRole": "HR"
}
]
}'
var apiClient = new ApiClient("https://api.boldsign.com", "{Your API Key}");
var templateClient = new TemplateClient(apiClient);
var templateRole = new Roles()
{
SignerName = "Alex",
SignerEmail = "alex@example.com",
SignerRole = "HR",
SignerType = SignerType.Signer,
RoleIndex = 1,
DeliveryMode = DeliveryMode.EmailAndSMS,
PhoneNumber = new PhoneNumber()
{
CountryCode="Signer’s Country Code",
Number = "Signer’s Phone Number"
},
};
var roles = new List<Roles>
{
templateRole,
};
var sendForSignFromTemplate = new SendForSignFromTemplate()
{
TemplateId = "Your_template_id",
Roles = roles
};
var documentCreated = templateClient.SendUsingTemplate(sendForSignFromTemplate);
import boldsign
configuration = boldsign.Configuration(host="https://api.boldsign.com", api_key="YOUR_API_KEY")
with boldsign.ApiClient(configuration) as api_client:
template_api = boldsign.TemplateApi(api_client)
phone_number = boldsign.PhoneNumber(
countryCode="Signer’s Country Code",
number="Signer’s Phone Number",
)
role = boldsign.Role(
roleIndex=1,
signer_name="Alex",
signer_email="alex@example.com",
signerType="Signer",
deliveryMode="EmailAndSMS",
phoneNumber=phone_number,
)
send_for_sign_from_template = boldsign.SendForSignFromTemplateForm(roles=[role])
document_created = template_api.send_using_template(
template_id="Your_Template_Id", send_for_sign_from_template_form=send_for_sign_from_template
)
<?php
require_once "vendor/autoload.php";
use BoldSign\Configuration;
use BoldSign\Api\TemplateApi;
use BoldSign\Model\Role;
use BoldSign\Model\PhoneNumber;
use BoldSign\Model\SendForSignFromTemplateForm;
$config = new Configuration();
$config->setHost('https://api.boldsign.com');
$config->setApiKey('YOUR_API_KEY');
$templateApi = new TemplateApi($config);
$role = new Role();
$role->setRoleIndex(1);
$role->setSignerName('Alex');
$role->setSignerEmail('alex@example.com');
$role->setSignerType('Signer');
$role->setDeliveryMode('EmailAndSMS');
$phoneNumber = new PhoneNumber();
$phoneNumber->setCountryCode('Signer’s Country Code');
$phoneNumber->setNumber('Signer’s Phone Number');
$role->setPhoneNumber($phoneNumber);
$sendForSignFromTemplate = new SendForSignFromTemplateForm();
$sendForSignFromTemplate->setRoles([$role]);
$documentCreated = $templateApi->sendUsingTemplate(
'YOUR_TEMPLATE_ID',
$sendForSignFromTemplate
);
ApiClient client = Configuration.getDefaultApiClient();
client.setBasePath("https://api.boldsign.com");
client.setApiKey("YOUR_API_KEY");
TemplateApi templateApi = new TemplateApi(client);
Role role = new Role();
role.setRoleIndex(1);
role.setSignerName("Alex");
role.setSignerEmail("alex@example.com");
role.setSignerType(Role.SignerTypeEnum.SIGNER);
role.setDeliveryMode(Role.DeliveryModeEnum.EMAIL_AND_SMS);
PhoneNumber phoneNumber = new PhoneNumber();
phoneNumber.setCountryCode("Signer’s Country Code");
phoneNumber.setNumber("Signer’s Phone Number");
role.setPhoneNumber(phoneNumber);
SendForSignFromTemplateForm sendForSignFromTemplate = new SendForSignFromTemplateForm();
sendForSignFromTemplate.setRoles(Arrays.asList(role));
try {
DocumentCreated documentCreated =
templateApi.sendUsingTemplate("Your_Template_Id", sendForSignFromTemplate);
} catch (ApiException e) {
System.err.println(e.getMessage());
}
import { TemplateApi, Role, SendForSignFromTemplateForm } from "boldsign";
const templateApi = new TemplateApi("https://api.boldsign.com");
templateApi.setApiKey("YOUR_API_KEY");
const role = new Role();
role.roleIndex = 1;
role.signerName = "Alex";
role.signerEmail = "alex@example.com";
role.signerType = Role.SignerTypeEnum.Signer;
role.deliveryMode = Role.DeliveryModeEnum.EmailAndSms;
role.phoneNumber = {
countryCode: "Signer’s Country Code",
number: "Signer’s Phone Number",
};
const sendForSignFromTemplate = new SendForSignFromTemplateForm();
sendForSignFromTemplate.roles = [role];
const documentCreated = await templateApi.sendUsingTemplate(
"Your_template_id",
sendForSignFromTemplate,
);
What should you know before you send by SMS?
A few rules apply to the text message side. Check them before you build SMS into your workflow:
- The SMS wording is fixed, so put any custom message in the email.
- The signer’s number must be in one of the 26 supported countries.
- The link opens in the phone’s browser, with no app or account needed.
Which plan do you need, and what does SMS delivery cost?
Envelope via SMS is on the Business, Premium and Enterprise API plans. Each text message costs $0.20 as an add-on, charged per SMS sent, in USD, as of November 2026.
You need the Enterprise API plan to send through the BoldSign API in production. It starts at $30 a month with 40 envelopes, and extra envelopes cost $0.75 each.
Webhooks, which report delivery failures, also need the Enterprise API plan. You can build and test first in a free API sandbox.
To send from the web app, Business costs $15 per user a month and Premium $99 a month for unlimited users, billed yearly. Both include unlimited templates. Try them with a 30-day free trial.
How do you start sending template requests by email and SMS?
Pick the next step that fits where you are:
- Create a free API sandbox account and send your first request.
- Schedule a demo to walk through template delivery with our team.
- Read how to detect email and SMS delivery failure with webhooks.
Questions about your setup? Reach our team through the support portal.
Frequently asked questions
Can I send one template signature request by both email and SMS?
Yes. Set deliveryMode to EmailAndSMS on the template role and add the signer's email address and phone number. We send the signing link to both.
Which deliveryMode values can a template role use?
A role accepts Email, SMS or EmailAndSMS. Email sends the link to the inbox only, SMS to the phone only, and EmailAndSMS to both.
What phone number format does the API expect?
Pass a phoneNumber object with two fields. The countryCode field holds the dialling code, and the number field holds the rest of the signer's number.
How do templates help with document generation email signature request workflows?
A template already holds the file, the roles and the fields. Your code only adds the signer details and the delivery mode, so each request is one short API call.
Can I change the text of the SMS that signers receive?
No. The SMS wording is fixed, so plan any custom message for the email instead. The text carries the signing link.
Does the signer need an app to sign from the text message?
No. The link opens the BoldSign signing page in the phone's browser. The signer signs right there, with no app to install.
Is a document signed from an SMS link legally binding?
Yes, when the signing meets the usual rules for electronic signatures in your country. The text only delivers the link, and we record each view and signature in the audit trail.
How much does each SMS cost?
Each text message costs $0.20 as an add-on, charged per SMS sent, in USD, as of November 2026. Emails carry no extra charge.