Agent skill · software engineering · sickn33
sendblue-api
Send and receive iMessage, SMS, and RCS from application code via the Sendblue HTTP API — text, media, group messages, send styles, reactions, typing indicators, status callbacks, and inbound webhooks.
Why this skill is useful
Provides specific API commands and workflows for integrating messaging features that the AI wouldn't reliably generate on its own.
What it needs
Requires sendblue account access. About 5k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.
What this skill does
Sendblue API Overview Sendblue is a REST API that sends iMessage (blue bubbles), SMS, and RCS from a provisioned phone number. Everything is plain JSON over HTTPS — no SDK is required. The API covers outbound 1:1 and group sends, iMessage effects, reactions, typing indicators, status callbacks, and inbound webhooks. When to Use This Skill Use when writing application code (server, worker, function) that sends Sendblue messages as part of a long-running service. Use when receiving inbound messages via webhooks. Use when you need features the CLI does not expose: send styles, reactions, group messages, typing indicators, status callbacks, media uploads, or the contacts API beyond basic CRUD. Reach for [[sendblue-cli]] instead for shell-context outbound: one-shot scripts, cron jobs, agent hooks, "ping me when X" workflows. How It Works Step 1: Authenticate Every request needs two headers: Keep both values server-side — never ship them to a browser or mobile client. Step 2: Send a message Phone numbers must be E.164. fromnumber must be a line you own — list yours with GET /api/lines. Step 3: Track delivery The synchronous response includes a messagehandle (Apple GUID — persist this; you need it for reactions and replies) and a status from REGISTERED, PENDING, QUEUED, ACCEPTED, SENT, DELIVERED, DECLINED, ERROR. Only DELIVERED means it landed. Use statuscallback instead of polling /api/status. Step 4: Receive inbound Configure webhook URLs in the dashboard or via POST /api/account/webhooks. Sendblue POSTs JSON to your endpoint. Respond with 2xx promptly — non-2xx triggers retries and duplicate deliveries. Event types: receive, outbound, typingindicator, calllog, lineblocked, lineassigned, contactcreated. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sickn33/sendblue-api