Skip to main content
POST
Send SMS Message

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
sendUserId
string
required

Sender user ID. Must belong to the team owning the API key.

from
string
required

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.

message
string
required

SMS body. lemlist variables such as {{firstName}} are resolved against the contact before sending, and the resolved message must not be empty.

contactId
string

Contact ID. Provide either contactId or leadId (not both required). Returned in the response.

leadId
string

Lead ID. Provide either contactId or leadId; when only leadId is sent, its contact is resolved and returned as contactId in the response.

Response

Success

ok
boolean

True when the SMS was sent.

contactId
string

The contact the SMS was sent to (resolved from leadId when only a lead was provided).