New Safe Mode warms up new numbers to cut the risk of a WhatsApp ban. Learn more →

Maytapi/Docs//catalog

/catalogFor WhatsApp Business numbers

WhatsApp Product Catalog API

Manage the product catalog of your WhatsApp Business number from your own system. Add products and collections, send a product or the whole catalog in a chat, and receive the orders customers place — without leaving your code.

  • products & collections
  • product messages
  • catalog messages
  • orders on webhook
WhatsApp product catalog and orders API
Endpoints

Your catalog, managed by the API

Keep the WhatsApp catalog in sync with your store instead of editing it by hand in the app.

  • catalog/addProduct

    Add and edit products

    Create products with a name, description, price, image, link and retailer id; edit or hide them later.

  • catalog/getProducts

    List products

    Read every product in the catalog, or a single product by id.

  • catalog/addCollection

    Collections

    Group products into collections and add or remove products from them.

  • type: product

    Product messages

    Send a single product card into a chat so the customer can view and order it.

  • type: catalog

    Catalog messages

    Share your whole catalog with a title and description in one message.

  • catalog/getOrders

    Orders

    Orders placed from the catalog arrive on your webhook; recent ones can also be listed through the API.

Products

Sync products from your store

Push products from your e-commerce system into the WhatsApp catalog with one request each. Update prices or hide sold-out items the same way.

  • ✓Name, description, price and image
  • ✓Product link and your own retailer id
  • ✓Hide a product without deleting it
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/addProduct" \
  -H "x-maytapi-key: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Classic sneaker",
    "description": "Canvas sneaker, sizes 38–45",
    "price": "49.90",
    "imageUrl": "https://example.com/sneaker.jpg",
    "url": "https://example.com/sneaker",
    "retailerId": "SKU-1042",
    "isHidden": false
  }'
Messages

Send a product or the whole catalog

When a customer asks, answer with the product card itself or the full catalog — both open natively in WhatsApp.

  • ✓type: product with the product id
  • ✓type: catalog with an optional title and description
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
  -H "x-maytapi-key: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to_number": "1415xxxxx67@c.us",
    "type": "product",
    "productId": "3121315354601301"
  }'
Orders

Receive orders on your webhook

When a customer sends an order from the catalog, it is delivered to your webhook like any other message. Save it to your own database — getOrders only keeps the orders received while the session is running.

  • ✓Order messages arrive in real time
  • ✓getOrders and getOrders/{orderId} for recent orders
  • ✓Store orders in your system for history
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getOrders" \
  -H "x-maytapi-key: $TOKEN"
Use cases

Who uses the catalog API

  • Online stores

    Keep the WhatsApp catalog identical to your web shop, prices included.

  • Sales teams

    Answer product questions with the product card instead of a long message.

  • Agencies and SaaS

    Manage catalogs for many client numbers from one platform.

FAQ

Product catalog FAQ

Ask our support team anything over WhatsApp. Average response time is under 24 hours.

Help center →
Do I need a WhatsApp Business account?

Yes. The catalog is a WhatsApp Business feature, so the connected number must be a WhatsApp Business number.

Are orders stored by Maytapi?

Orders are delivered to your webhook in real time. getOrders only returns orders received while the session is running, so save them to your own database for a permanent history.

Can I send a single product in a chat?

Yes. Send a message with type product and the product id; the customer sees the native product card.

Can I group products?

Yes. Create collections and add or remove products from them through the API.

Start using the WhatsApp API

Get your key, send your first message in ten minutes

No approval, no templates, no card. Every endpoint is open for three days.