Skip to main content
Use these guides to move from your first request to a production integration.

Choose a workflow

Start with a task guide when you know what you want to build. Each task guide explains what the feature does, prerequisites, how it works, a complete request, the response, final status, and common failure modes.

Send a WhatsApp message

Choose between queued and direct sending.

Send an SMS

Send text messages and track delivery.

Send an email

Send HTML or plain-text email.

Handle inbound messages

Receive messages, mark them as read, and show typing indicators.

Send a voice code

Deliver a verification code through an automated call.

Build on WhatsApp

Business Accounts

Inspect connected WABAs, verification, restrictions, and messaging limits.

Phone numbers

Register senders and manage profiles, commerce, and calling settings.

WhatsApp message pricing

Understand pricing fields, charging rules, and when message prices become final.

Templates

Create and manage approved message structures.

Flows

Build, preview, publish, and deprecate structured experiences.

Media

Upload reusable media for WhatsApp messages.

Calling

Connect, accept, reject, and terminate calls.

Business-scoped user IDs

Send messages and calls without relying on a user’s phone number.

Manage customer data

Contacts

Create and maintain customer profiles.

Custom Events

Define and send customer activity events.

Unsubscribers

Record and enforce channel opt-outs.

Balance

Monitor available account funds and currency.

Understand the API

Authentication

Authenticate securely with an API key.

Errors

Handle failures and retries safely.

Pagination

Iterate through list endpoints.

Webhooks

Receive events from YCloud.

Adapt a working example

Annotated examples

Follow visual walkthroughs with instructions, requests, responses, and implementation notes.

WhatsApp template creation

Create template variants with screenshots and annotated request examples.

Webhook walkthroughs

Review prerequisites, event behavior, and scenario-specific payloads.

All webhook payloads

Explore every supported event type and named payload example.

Move from guide to reference

Use a guide to understand behavior and integration choices. Use the API Reference to inspect every request field, response field, and enum value. Use webhook examples to test your event handler before production traffic arrives.