50% OFF with code BLACKFRIDAY5020% OFF with code BLACKFRIDAY20
Integrations & APIAll plans

Public API: overview and keys

The Menuthere API lets your own POS or software act on your store. Menuthere support creates a key for you with access to Orders, WhatsApp or both, and your software calls the endpoints with it. A key can only ever see and change your own data.

Where
Ask Menuthere support for a key
Plan
The dashboard does not lock API keys by plan. Sending WhatsApp templates also needs a connected WhatsApp number, which starts on Starter / Pro.
Time
5 min
Updated

Create and manage keys

Step 1: Ask Menuthere support for a key

API keys are not in the dashboard yet, so Menuthere support creates them. Tell support what the key is for, such as “Billing POS”.

Step 2: Choose its access

A key with Orders access can update the status of your orders. One with WhatsApp access can send WhatsApp templates. Ask only for what your software needs.

Step 3: Save the key straight away

A key is shown once, when it is created. Menuthere keeps only a fingerprint, so it cannot be shown again. Put it in your software's settings at once. If you lose it, ask support to revoke it and make another.

Using a key

Send the key as Authorization: Bearer ck_live_… from your server. Never put it in a browser page or a mobile app, because anyone who reads it can change your orders. A one-line example:

curl -X POST 'https://menuthere.com/api/v1/orders/ORDER_ID/status' -H 'Authorization: Bearer ck_live_YOUR_KEY' -H 'Content-Type: application/json' -d '{"status":"accepted"}'

EndpointAccess neededPage
POST /api/v1/orders/{order_id}/statusOrdersAPI: update an order's status
GET /api/v1/whatsapp/templatesWhatsAppAPI: list and send WhatsApp templates
POST /api/v1/whatsapp/send-templateWhatsAppAPI: list and send WhatsApp templates
StatusErrorMeaning
401missing_api_key, invalid_api_keyNo key sent, or the key is wrong or revoked.
403scope_deniedThe key does not have the access this endpoint needs.
429rate_limitedToo many requests this minute. Each key defaults to 120 a minute.
Good to knowYou can have up to 10 active keys. Ask Menuthere support to revoke a key you no longer use. Anything using it stops working at once, and a revoked key cannot be restored.

Questions

Can a key see another restaurant's orders?
No. Each key belongs to one restaurant. Every request is checked against that restaurant, so an order from another account is reported as not found.
I lost my key. Can you show it again?
No. Only a fingerprint is stored. Ask Menuthere support to revoke the old key and make a new one, then update your software.

Can't find it? Email help@mail.menuthere.com or chat with us, 9 AM – 9 PM.Help centerPricingmenuthere.com