Home

Send SMS messages to your Free Mobile device via any internet-connected device.

For example, you can configure a control panel or storage connected to your home network to send a notification to your mobile phone when an event occurs.

Quick start

Note

SMS notifications require an API key. If you are not already registered, sign up for a Free Mobile account.

Get an API key

You first need to enable the SMS notifications in your subscriber account. This will give you an identification key allowing access to the Free Mobile API.

Get the library

Install the latest version of Free Mobile for .NET with your package manager:

# .NET with NuGet
dotnet add package Belin.FreeMobile

# PowerShell with PSResourceGet
Install-PSResource FreeMobile

For detailed instructions, see the installation guide.

.NET/C# usage

This library provides the Client class, which allow to send SMS messages to your mobile phone by using the SendMessage() or SendMessageAsync() method:

using Belin.FreeMobile;
using System;
using System.Net.Http;

try {
  var client = new Client("your account identifier", "your API key");
  await client.SendMessageAsync("Hello World from .NET!");
  Console.WriteLine("The message was sent successfully.");
}
catch (HttpRequestException e) {
  Console.Error.WriteLine($"An error occurred: {e.Message}");
}

The Client.SendMessageAsync() method returns a Task that completes when the message has been sent.

Warning

The text of the messages will be automatically truncated to 160 characters:
you can't send multipart messages using this library.

PowerShell usage

This library provides the Send-FreeMobileMessage cmdlet, which allows you to send SMS notifications to your mobile phone:

Import-Module FreeMobile

$credential = [pscredential]::new("Your account identifier", (ConvertTo-SecureString "Your API key" -AsPlainText))
Send-FreeMobileMessage "Hello World from PowerShell!" -Credential $credential
Write-Output "The message was sent successfully."

Warning

The text of the messages will be automatically truncated to 160 characters:
you can't send multipart messages using this library.