Astrology Platform API Integration Guide

Whether you're building a new astrology consultation app or adding messaging to an existing platform, this guide covers what it actually takes to integrate MetaReach's OTP, WhatsApp, SMS, and IVR APIs — authentication, endpoints, webhooks, and a realistic timeline for a working integration.

What You Can Integrate

Five API Surfaces, One Integration Layer

OTP API — trigger login/signup OTP via a single REST call, receive delivery status via webhook
WhatsApp API — send session reminders, kundli/report attachments, and template messages programmatically
Bulk SMS API — schedule and send daily horoscope content to segmented subscriber lists
IVR/Call Routing API — configure and trigger call-routing logic for consultation calls
Missed Call Webhook — receive real-time lead notifications the moment a missed call registers

Quick Answer — Astrology Platform API Integration

MetaReach's API integration for astrology platforms uses API key authentication, REST/JSON endpoints for OTP, WhatsApp, SMS, and IVR, and webhook callbacks for real-time delivery status. A sandbox environment is available for end-to-end testing before switching to production credentials.

Endpoints

Core API Endpoints

All endpoints accept and return JSON over HTTPS, authenticated via an API key in the request header.

Method	Endpoint	Purpose
POST	/v1/otp/send	Send a login/signup OTP to a phone number
POST	/v1/otp/verify	Verify a user-submitted OTP code
POST	/v1/whatsapp/send	Send a WhatsApp template message (reminder, kundli delivery, etc.)
POST	/v1/sms/send	Send a single or bulk SMS (e.g. horoscope batch)
GET	/v1/messages/{id}/status	Poll the delivery status of a sent message
POST	/v1/webhooks/register	Register a callback URL for real-time delivery status events

Sample Request — Send OTP

POST /v1/otp/send

Authorization: Bearer YOUR_API_KEY

Content-Type: application/json

{

  "phone": "+91XXXXXXXXXX",

  "template_id": "otp_login_v1",

  "sender_id": "ASTROX"

}

Sample Webhook Payload — Delivery Status

{

  "message_id": "msg_8f2a1c",

  "channel": "sms",

  "status": "delivered",

  "timestamp": "2026-08-27T10:15:32+05:30"

}

Illustrative example only — actual field names and response formats are provided in full during onboarding.

Authentication & Setup

Getting From Signup to Your First Live Call

Get API credentials — issued during onboarding, includes a sandbox key for testing before going live
DLT sender-ID registration — required before any production SMS/WhatsApp sends; MetaReach handles this as part of setup
Webhook endpoint setup — register your callback URL to receive delivery status, inbound replies, and missed-call events

Sandbox & Testing

Test Before You Touch Production

A sandbox environment is available before production access, so you can test OTP flows, message templates, and webhook handling without sending real messages to real numbers. Typical integration timeline for a basic OTP + WhatsApp send-and-track setup: 1-2 weeks for a team already familiar with REST APIs.

Common Integration Patterns

How Teams Actually Wire This In

Login Flow

App calls OTP API → user enters code → app verifies via MetaReach's verification endpoint.

Session Reminder Flow

Booking system triggers a scheduled WhatsApp send via webhook, timed relative to session start.

Daily Horoscope Flow

Scheduled job calls the Bulk SMS API against a segmented subscriber list each morning.

Missed Call Lead Flow

MetaReach webhook fires to your CRM/lead system the instant a missed call registers.

Go Further

Beyond the API Docs

The non-technical side of each tool this API powers.

OTP Authentication

Overview of login and signup OTP for astrology apps.

Explore OTP Authentication

WhatsApp API for Astrologers

Session reminders, kundli delivery, and follow-up messages on WhatsApp.

Explore WhatsApp for Astrologers

Bulk SMS for Daily Horoscope Alerts

Daily horoscope and panchang push notifications at scale.

Explore Horoscope Alerts

IVR for Astrology Call Consultations

Route incoming calls to the right astrologer automatically.

Explore Call Routing

Missed Call Service for Astrology Leads

Zero-cost missed-call lead capture for individual astrologers.

Explore Missed Call Leads

Astrology Case Studies

See how consultation platforms and astrologers use this infrastructure.

View Case Studies

MetaReach API Docs

General API documentation covering the full MetaReach messaging platform.

View API Docs

Scripting & Templates

Sample templates and scripts for common messaging workflows.

View Scripts

Messaging API Integration Guide for SaaS & ERP

Cross-vertical reference — astrology platforms are technically SaaS products too.

View SaaS & ERP Integration Guide

Common Questions

Frequently Asked Questions

Is there a sandbox environment for testing before going live?

Yes — sandbox access with test credentials is provided during onboarding, before any production sending.

How long does a typical integration take?

For a team already familiar with REST APIs, a basic OTP + WhatsApp integration typically takes 1-2 weeks. More complex flows (IVR routing, multi-channel orchestration) take longer.

Do I need DLT registration before testing in sandbox?

No — sandbox testing doesn't require DLT registration. It's required before production/live sending.

Can I integrate just one channel (e.g., only OTP) without the others?

Yes — each API (OTP, WhatsApp, SMS, IVR) can be integrated independently based on what your platform needs.