Introduction

Welcome to the Blueticks API reference. These docs cover the v1 public API — stable endpoints we guarantee won't break within a major version.

What you can build

• Send WhatsApp messages from your backend — right now or scheduled for later.
• Run templated campaigns to a contact list and track delivery end to end.
• React to inbound messages and delivery events in real time via webhooks.
• Integrate Blueticks into existing customer-support, CRM, or marketing pipelines.
• Generate AI songs with Suno — turn lyrics and a style into music using the same API key and auth.

Before you start

1. You need a Blueticks account with an API key. See Authentication for how to get one.
2. Pick an SDK: we ship official clients for Python, Node.js, PHP, Ruby, and Go. The Quickstart walks through each.
3. Plugging Blueticks into an LLM agent? See the MCP server — a local stdio bridge exposing every Blueticks resource as an MCP tool, ready to drop into Claude Code, Claude Desktop, Cursor, or any other MCP-compatible host.

Next steps

• Quickstart — install the SDK, send your first ping.
• Sending messages — send now or schedule text, media, and polls.
• Receiving webhooks — HTTPS callbacks for message, session, and campaign events.
• Running campaigns — templated sends to an audience with per-contact variables.
• Authentication — API keys and headers.
• Errors & retries — how the API reports problems and what your client should do about them.
• MCP server — drop Blueticks into Claude Code, Cursor, or any other MCP host.
• API Reference — every endpoint, with an interactive playground.