Introduction

This guide will help you get started with Sendblue and understand the basics of how to use the platform. If you just want to start sending messages right away, jump to the Quickstart.

Setup

The fastest way to get started is with the Sendblue CLI:

npm install -g @sendblue/cli
sendblue setup

The CLI will walk you through creating an account, assigning you a phone number, and verifying your first contact.

On free plans, a recipient must be a verified contact before you can message them. During setup, you’ll add a contact — that person needs to send any text to your Sendblue number to complete verification.

To remove this restriction, talk to us about our dedicated plans.

View Your API Keys

sendblue show-keys

These are the same credentials shown in the dashboard. Use them as SB-API-KEY-ID and SB-API-SECRET-KEY headers in API requests.

Already Have an Account?

If you already have Sendblue API credentials:

sendblue login

For enterprise use cases, please reach out to sales.

Community Integrations

Here are two open-source projects built on Sendblue:

TextMe — Claude via iMessage

TextMe turns your Mac into a personal Claude AI you can text from anywhere. Send messages, voice notes, or images — Claude responds directly to your phone via iMessage.

1. Install requirements:

npm install -g @sendblue/cli
npm install -g @anthropic-ai/claude-code

2. Get your Sendblue credentials:

sendblue setup
sendblue show-keys

3. Install:

git clone https://github.com/njerschow/textme.git
cd textme/daemon && npm install && npm run build

4. Configure — create ~/.config/claude-imessage/config.json:

mkdir -p ~/.config/claude-imessage

{
  "sendblue": {
    "apiKey": "YOUR_API_KEY",
    "apiSecret": "YOUR_API_SECRET",
    "phoneNumber": "+1SENDBLUE_NUMBER"
  },
  "whitelist": ["+1YOUR_PHONE"]
}

5. Run (from inside textme/daemon/):

npm start

Text your Sendblue number and Claude will respond.

openclaw-sendblue — Text Your AI Agent

openclaw-sendblue is a plugin for openclaw that adds iMessage and SMS as a communication channel, so you can interact with your AI agent over text.

1. Get your Sendblue credentials:

npm install -g @sendblue/cli
sendblue setup
sendblue show-keys

2. Install the plugin:

git clone https://github.com/njerschow/openclaw-sendblue ~/.openclaw/extensions/sendblue
cd ~/.openclaw/extensions/sendblue && npm install && npm run build

3. Configure — add this to ~/.openclaw/openclaw.json:

{
  "plugins": {
    "entries": {
      "sendblue": {
        "enabled": true,
        "config": {
          "apiKey": "YOUR_API_KEY",
          "apiSecret": "YOUR_API_SECRET",
          "phoneNumber": "+15551234567",
          "allowFrom": ["+15559876543"]
        }
      }
    }
  }
}

4. Restart and test:

openclaw gateway restart

Text the Sendblue number from your phone — openclaw will respond.

Both projects are MIT licensed.