SMS

Node Configuration

{
  "nodeType": "SendSMS",
  "name": "sendApprovalSms",
  "config": {
    "credentialId": 15,
    "provider": "twilio",
    "from": "+15551234567",
    "to": "$output.fetchEmployee.mobilePhone",
    "body": "Action required: Invoice $output.createInvoice.invoiceNumber needs your approval. Log in at $context.appUrl",
    "statusCallbackUrl": null,
    "retryCount": 2,
    "retryDelayMs": 3000
  }
}

Configuration Fields

Twilio Credential Storage

Twilio requires two values: Account SID and Auth Token. These are stored as a JSON object in the credential store and retrieved atomically:

// Stored credential value (JSON string)
// { "accountSid": "ACxxxxx", "authToken": "token-value" }

var rawCredential = await _credentials.GetPasswordAsync(config.CredentialId, ct);
var twilioAuth = JsonSerializer.Deserialize<TwilioCredential>(rawCredential);

TwilioClient.Init(twilioAuth.AccountSid, twilioAuth.AuthToken);
var message = await MessageResource.CreateAsync(
    to: new PhoneNumber(config.To),
    from: new PhoneNumber(config.From),
    body: evaluatedBody
);

SMSChannelAdapter

public class SMSChannelAdapter : IMessagingChannelAdapter
{
    public string ChannelType => "SMS";

    public async Task<MessagingResult> SendAsync(
        MessagingMessage message,
        MessagingConfig config,
        CancellationToken ct)
    {
        var rawCredential = await _credentials.GetPasswordAsync(config.CredentialId, ct);
        var auth = JsonSerializer.Deserialize<TwilioCredential>(rawCredential)!;

        TwilioClient.Init(auth.AccountSid, auth.AuthToken);

        var msg = await MessageResource.CreateAsync(
            to: new PhoneNumber(message.To),
            from: new PhoneNumber(config.From),
            body: message.Body,
            statusCallback: config.StatusCallbackUrl != null
                ? new Uri(config.StatusCallbackUrl)
                : null
        );

        return new MessagingResult
        {
            MessageId = msg.Sid,
            Channel = "sms",
            Recipient = message.To,
            SentAt = DateTimeOffset.UtcNow,
            Status = msg.Status.ToString().ToLower()
        };
    }
}

Node Output

{
  "messageId": "SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "channel": "sms",
  "sentAt": "2026-05-25T10:00:00Z",
  "status": "queued",
  "recipient": "+447700900123"
}