Zid Docs
AppsThemes
Payments
AppsThemes
Payments
Help Center
Slack
  1. Authentication
  • Getting Started
    • Introduction
    • Theme Development
    • Vitrin Changelog
    • Creating and Managing Theme Presets
    • Legacy Theme Migration
      • Store Settings Mapping
      • Moving to Vitrin Using LLMs
      • Twig to Jinja
      • Breaking Changes
  • Key Concepts
    • Architecture
    • Templates
      • Overview
      • Overridable Templates
      • Legacy Templates
      • Template Replacements
      • Templates Library
        • home.jinja
        • product.jinja
        • cart.jinja
        • category.jinja
        • products.jinja
        • categories.jinja
        • page.jinja
        • blogs.jinja
        • blog.jinja
        • faqs.jinja
        • reviews.jinja
        • questions.jinja
        • shipping_payment.jinja
        • 404_not_found.jinja
    • Settings
      • Schema files
      • Input Settings
      • Media Settings
      • Form Controls Settings
      • Products Settings
      • Additional Settings
      • Conditional Visibility
      • Migrating twig settings schema
    • Localization
      • localization (jinja v. twig)
    • Theme Editor
      • Overview
  • Building with Vitrin
    • Jinja Basics
    • Vitrin's Jinja Extensions
  • Vitrin CLI
    • Introduction
    • CLI Commands
  • Tips & Tricks
    • Performance
  • JS Integration
    • Supporting both Vitrin and Legacy themes
    • Responses & Errors
    • Cart
    • Products
    • Categories
    • Store
    • Account
    • Blogs
    • Options
    • Events
  • Features
    • SDK Popups – Integration Guidelines
    • Custom Styles Guide
    • Gift Card as a Popup
    • Addresses as a Popup
    • Login as a Popup
    • Checkout as a Popup
    • Apple Pay Quick Checkout
    • Region & Language Popup
    • Dynamic Bundle Products
    • Progressive Discounts
    • Customer Wallet & Cashback
    • Add Preorder Support to Your Theme
  • Mobile Apps
    • Scripts
  • API's
    • Authentication
      • Logout
        POST
      • Login Status
        GET
      • SMS Login
        POST
      • Verify SMS Login
        POST
      • WhatsApp Login
        POST
      • Verify WhatsApp Login
        POST
      • Email Login
        POST
      • Verify Email Login
        POST
      • Register
        POST
      • Register Guest
        POST
    • Products
      • List Products
      • Search Products
      • Calculate Product Options Price
      • Notify Product Stock Availability
      • Fetch Bundle Offers
      • Fetch Bundle Offers for a Product
      • List My Product Reviews
      • List Product Reviews
      • Create Product Review
      • Update Product Review
      • Delete Product Review
      • List Product Questions
      • Create Product Question
      • Get Product by Slug
      • Get Selection Groups
    • Categories
      • List Categories
    • Checkout
      • Get Cart
      • Remove Cart
      • Duplicate Cart
      • Add Cart Item
      • Empty Cart
      • Update Cart Item
      • Remove Cart Item
      • Upload Cart Input Field
      • Add Gift Card
      • Remove Gift Card
      • Apply Coupon
      • Remove Coupon From Cart
      • Check Coupon Validity
      • Apply Loyalty Points
      • Remove Loyalty Points
      • Preview Rewarded Points
      • List Redemption Methods for Cart
      • Customer’s Loyalty Wallet
      • Customer’s Current Points Balance
    • Account
      • Get Profile
      • Delete Account
      • Update Customer Profile
      • Get Addresses
      • Create an Address
      • Get an Address by ID
      • Update an Existing Address
      • Delete Address
      • Get Orders
      • Get Shareable Wishlist Link
      • Get Wishlist
      • Add Products to Wishlist
      • Remove Product from Wishlist
      • Get Address Form Schema
      • Check Product Purchase Status
    • Storefront
      • Store Scripts
      • Pages
      • Blogs
    • Countries
      • Get Countries
      • Get Cities By Country
  1. Authentication

Verify WhatsApp Login

Developing
POST
{store_url}/api/v1/auth/whatsapp/verify
Verifies the code sent to the customer’s mobile number through WhatsApp. After successful verification, the response indicates whether the customer can continue with login or must complete the registration process.

Request

Body Params application/x-www-form-urlencodedRequired

Responses

🟢200Success
application/json
Bodyapplication/json

🟠422
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff '{store_url}/api/v1/auth/whatsapp/verify' \
--data-urlencode 'mobile_number=501234567' \
--data-urlencode 'country_code=+966' \
--data-urlencode 'code=1234' \
--data-urlencode 'is_newsletter_subscriber=true'
Response Response Example
200 - Example 1
{
    "login_type": "signup",
    "status": "registration_needed",
    "channel": "whatsapp",
    "mobile_number": "501234567",
    "country_code": "+966",
    "email": "customer@example.com",
    "mobile": "+966501234567",
    "email_exists": true,
    "sent_at": "2026-06-21T10:30:00Z",
    "cart_session_id": "cart_session_8f7c2a91",
    "is_active_abandoned_cart_merged": true,
    "customer_id": 12345,
    "has_addresses": true,
    "property1": {},
    "property2": {}
}
Modified at 2026-06-21 10:45:40
Previous
WhatsApp Login
Next
Email Login
Built with