> For the complete documentation index, see [llms.txt](https://squadinc.gitbook.io/squad-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://squadinc.gitbook.io/squad-api-documentation/value-added-services/sms.md).

# SMS

These are a suite of APIs that allow you to vend SMS. Please note you are expected to fund your specified GTBank virtual account from which your VAS dashboard is credited.

{% hint style="danger" %}
**This documentation site has been deprecated as of September 8, 2025, and will no longer receive updates. Please refer to the new documentation site at** [**https://docs.squadco.com**](https://docs.squadco.com)**.**
{% endhint %}

### API KEYS AND AUTHORIZATION

1. Once profiled, log in details will be sent to you
2. [Log into your account ](https://vas.squadco.com/)
3. Once logged in, you can retrieve keys and other credentials for calling API endpoints

{% hint style="info" %}
The API endpoints are authorized using the **key** and **secret**, they should be passed as headers in the request. 
{% endhint %}

**Generating a Secret:** This is done by using crypto to sign the strings `${client_id} ${user_id} ${current date in YYYY-MM-DD}.`e.g for client 41, user 9 and date September 11, 2023, you should encrypt 41 9 2023-09-11. Use the **key** and **IV**  gotten from your dashboard to do this.

{% hint style="info" %}
 **Secret** should be generated each day or on each request for security purposes
{% endhint %}

**CODE SNIPPETS FOR ENCRYPTING SECRET**

{% tabs %}
{% tab title="C#" %}

```
using System;
using System.IO;
using System.Security.Cryptography;
using System.Text;

public string Encrypt(string text, string keyString, string ivString)
{

    using (RijndaelManaged myRijndael = new RijndaelManaged())
    {
        byte[] key = Encoding.ASCII.GetBytes(keyString);
        byte[] iv = Encoding.ASCII.GetBytes(ivString);
        byte[] encrypted;
        using (RijndaelManaged rijAlg = new RijndaelManaged())
        {
            ICryptoTransform encryptor = rijAlg.CreateEncryptor(key, iv);
            using (MemoryStream msEncrypt = new MemoryStream())
            {
                using (CryptoStream csEncrypt = new CryptoStream(msEncrypt, encryptor, CryptoStreamMode.Write))
                {
                    using (StreamWriter swEncrypt = new StreamWriter(csEncrypt))
                    {
                        swEncrypt.Write(text);
                    }
                    encrypted = msEncrypt.ToArray();
                }
            }
        }
        string base64String = Convert.ToBase64String(encrypted);
        return base64String;
    }
}

```

{% endtab %}

{% tab title="Node JS" %}

```
const crypto = require("crypto");

const encrypt = (text, keyString, ivString) => {
	const cipher = crypto.createCipheriv("aes256", keyString, ivString);
	let encrypted = cipher.update(text, "utf8", "base64");
	encrypted += cipher.final("base64");
	return encrypted;
};

```

{% endtab %}

{% tab title="PHP" %}

```
function encrypt($text, $keyString, $ivString) {
    $cipher = "aes-256-cbc";
    $encrypted = openssl_encrypt($text, $cipher, $keyString, OPENSSL_RAW_DATA, $ivString);
    return base64_encode($encrypted);
}
```

{% endtab %}
{% endtabs %}