Skip to main content
Version: v1.4

Setup

warning

These instructions are for personal or educational use only.
Using multiple accounts, automated messaging, or any activity that violates Signal's Terms of Service may result in account suspension or legal action.
We do not endorse spam or fraudulent activity!
Furthermore, we are not in any way affiliated with the Signal Foundation.

To use Secured Signal API for the first time you will need to set up and link your signal account. In this section we'll take you quickly through what's needed.

important

Run setup directly with Signal CLI REST API. Setup requests via Secured Signal API will be blocked by default

Register​

To be able to send messages via Secured Signal API you must first set up Signal CLI REST API. Here we'll be registering a new signal account.

SMS Verification​

curl -X POST \
    -H "Content-Type: application/json" \
    'http://signal-cli-rest-api:8080/v1/register/<number>'

Example:

curl -X POST \
    -H "Content-Type: application/json" \
    'http://signal-cli-rest-api:8080/v1/register/+431212131491291'

Voice Verification​

curl -X POST \
    -H "Content-Type: application/json" \
    -d '{"use_voice": true}' \
    'http://signal-cli-rest-api:8080/v1/register/<number>'

Example:

curl -X POST \
    -H "Content-Type: application/json" \
    -d '{"use_voice": true}' \
    'http://signal-cli-rest-api:8080/v1/register/+431212131491291'

If you don't want to register a new account you can link Secured Signal API to one instead.

curl -X GET \
    -H "Content-Type: application/json" \
    'http://signal-cli-rest-api:8080/v1/qrcodelink?device_name=<device name>'

This will show you a QR-Code which you will be able to use for linking.

Troubleshooting​

If you encounter any issues in the steps above look at the examples provided by @bbernhard