Free Mobile

The free_mobile platform uses the French mobile operator Free Mobile to send SMS to your own cell phone.


Before doing anything, you have to activate the SMS API option in your Free Mobile account (In “Gérer mon compte -> Mes Options”). Activating this option will automatically generate a token which is required in your configuration.

This API only sends classic SMS messages and only to the cell phone of the account owner. So you only have to provide a text message in your payload.

If you disable and re-enable the SMS API option, please be sure to update your token in your configuration.


To use this notification platform in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
    platform: free_mobile
    username: YOUR_ACCOUNT_ID
    access_token: TOKEN

Configuration Variables

name string (Optional, default: notify)

The optional parameter name allows multiple notifiers to be created. The notifier will bind to the service notify.NOTIFIER_NAME.

username string Required

This is the id given by FreeMobile to access your online account.

access_token string Required

You can get this token by activating the SMS API in your online account.