Developer tools

Postman

Try every endpoint from BlueBot’s Postman collection before you write any code.

What you can do

Import BlueBot’s Postman collection and send your first text to yourself without writing code.
Try every endpoint with your own API key, such as sending a text or checking your Mac.
See how Idempotency-Key keeps a retried request from sending twice.

API
Your own code calls BlueBot’s REST API and listens to its signed webhooks.
API in the docs

Recipes

Set one up as written, or change it to fit how you work. The docs have the same recipes step by step.

01With the API

Starts when

You send a request from Postman

Import BlueBot’s Postman collection and add your API key to the collection’s authorization.
Open the request for POST /v1/messages and set the to field to your own number and the text field to a short message.
Send it, then open GET /v1/messages/{id} with the id it returned to watch the state move from queued to sent to delivered.

The text it sends

Hello from Postman.

From your own number

02With the API

Starts when

You send a request from Postman

Send GET /v1/device to see whether your Mac is online, when it last checked in and how many texts are held.
Send GET /v1/lookup with a number to see whether it’s likely on iMessage, and on what basis.

03With the API

Starts when

You send the same request twice

Send POST /v1/messages with an Idempotency-Key header.
Send the same request again with the same key, and BlueBot answers with the first message instead of sending another.
Change the body but keep the key, and BlueBot answers 409 idempotency_conflict.

The text it sends

Testing a retry from Postman.

From your own number

You need a card to start the trial. After 7 days it’s $17.99 a month plus any tax, and you can cancel from your billing page at any time.