For the complete documentation index, see llms.txt. This page is also available as Markdown.

Quick start

This guide walks you from sending a test message to full use of WhatsApp Business API (WABA) in six simple steps.

Step 1. Create an account

You need an account on platform.1msg.io to get started.

Go to the registration page, enter your email and password, and click Sign up. Alternatively, use the Facebook icon below the registration form.

Step 2: Activate the Test channel

You don’t have to wait for Meta approval β€” start testing right away.

  1. Scan the QR code in your dashboard or click "Write to WhatsApp" and send the generated code to the test WABA number.

  1. Your account will automatically connect to the test WABA channel.

  2. You can chat with your phone number on WhatsApp.

βœ… Test channel is ready. A $5 bonus has been credited to your balance for testing paid templates and sessions.

Why use the Test channel?

Connect to our pre-configured WABA test number β€” no Meta approval or additional setup required.

  • send and receive WhatsApp messages;

  • test webhooks and API methods;

  • verify your integration flow before connecting your own WABA number.

Test limitations:

  • Messages can be sent only to your own WhatsApp numbers.

Step 3: Send your first message

Once your test channel is created, you can send your first API message.

Click "Send" and check the message in your WhatsApp chat with the test WABA number.

Example request

You can find your channel ID and token on the channel page.

Request body (JSON):

You can find more API methods in Playground

Step 4: Try more API methods in Playground

In a couple of minutes, verify that the messaging API works end to end.

  1. Send another message in one click and receive it instantly on your WhatsApp number.

  2. In the UI you’ll see a ready-made JSON request you can use in your code, plus the send response and the webhook payload.

Step 5: Configure webhooks

Teach your system to β€œlisten” to WhatsApp.

  1. Set your webhook URL in the channel settings.

  2. Incoming messages, delivery statuses (sent, delivered, read), and profile changes will be delivered to your server in real time.

  3. Test webhook handling in your integration using webhook simulation from Playground.

Step 6: API, SDK, and developer tools

Once the flow is clear, move on to automation. Use our resources to ship faster:

API documentation β€” full description of all methods in OpenAPI format

Postman collection

SDK β€” ready-made libraries for Node.js, Python, and PHP with code examples.

MCP (Model Context Protocol) β€” connect our API directly to your AI assistant (Cursor, Claude Desktop) to generate integration code on the fly.

Coming soon.

Step 6: Go to production

Ready to launch for real customers?

  1. In the left menu, go to Add new channel.

  2. Choose a plan for your channel and pay the subscription via Stripe in the dashboard.

  3. Connect your own number: use the Embedded Signup flow to register your business number with Meta quickly.

  4. Configure API, webhooks, and message templates β€” then start broadcasts, chatbots, and everything else the 1MSG API offers.

For a tutorial on connecting a WABA channel, see:

Connection WABA

Last updated