curl --request POST \
--url https://api.lemlist.com/api/inbox/sms \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"sendUserId": "usr_Example123UserAbc",
"from": "+33612345678",
"message": "Hi {{firstName}}, following up on our conversation"
}
'import requests
url = "https://api.lemlist.com/api/inbox/sms"
payload = {
"sendUserId": "usr_Example123UserAbc",
"from": "+33612345678",
"message": "Hi {{firstName}}, following up on our conversation"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
sendUserId: 'usr_Example123UserAbc',
from: '+33612345678',
message: 'Hi {{firstName}}, following up on our conversation'
})
};
fetch('https://api.lemlist.com/api/inbox/sms', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://api.lemlist.com/api/inbox/sms")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"sendUserId\": \"usr_Example123UserAbc\",\n \"from\": \"+33612345678\",\n \"message\": \"Hi {{firstName}}, following up on our conversation\"\n}"
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lemlist.com/api/inbox/sms",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'sendUserId' => 'usr_Example123UserAbc',
'from' => '+33612345678',
'message' => 'Hi {{firstName}}, following up on our conversation'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"ok": true,
"contactId": "ctc_Example123Contact"
}{
"error": "Bad team"
}"The authentication you supplied is incorrect"{
"error": "Not enough credit to send the sms"
}Send SMS Message
Sends an SMS message to a contact through the lemlist inbox.
curl --request POST \
--url https://api.lemlist.com/api/inbox/sms \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"sendUserId": "usr_Example123UserAbc",
"from": "+33612345678",
"message": "Hi {{firstName}}, following up on our conversation"
}
'import requests
url = "https://api.lemlist.com/api/inbox/sms"
payload = {
"sendUserId": "usr_Example123UserAbc",
"from": "+33612345678",
"message": "Hi {{firstName}}, following up on our conversation"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
sendUserId: 'usr_Example123UserAbc',
from: '+33612345678',
message: 'Hi {{firstName}}, following up on our conversation'
})
};
fetch('https://api.lemlist.com/api/inbox/sms', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://api.lemlist.com/api/inbox/sms")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"sendUserId\": \"usr_Example123UserAbc\",\n \"from\": \"+33612345678\",\n \"message\": \"Hi {{firstName}}, following up on our conversation\"\n}"
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lemlist.com/api/inbox/sms",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'sendUserId' => 'usr_Example123UserAbc',
'from' => '+33612345678',
'message' => 'Hi {{firstName}}, following up on our conversation'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"ok": true,
"contactId": "ctc_Example123Contact"
}{
"error": "Bad team"
}"The authentication you supplied is incorrect"{
"error": "Not enough credit to send the sms"
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Body
Sender user ID. Must belong to the team owning the API key.
Sender phone number, in E.164 format. Must be a phone number provisioned on your team; an unknown, pending or deleted number fails with Failed to send SMS.
SMS body. lemlist variables such as {{firstName}} are resolved against the contact before sending, and the resolved message must not be empty.
Contact ID. Provide either contactId or leadId (not both required). Returned in the response.
Lead ID. Provide either contactId or leadId; when only leadId is sent, its contact is resolved and returned as contactId in the response.
Was this page helpful?