Conversora Logo
Conversora
Merchant Console
Developer API, Webhooks & Meta MCP•Developer•Advanced

Headless Commerce REST API & Webhook Subscriptions

Integrate Conversora with custom mobile apps, external ERPs, point-of-sale systems, and warehouse barcode scanners using our secure REST API.

7 min read•Updated 2026-09-18
In This Guide
  • Generate scoped API tokens with granular permissions (Read Products, Manage Orders, Update Stock).
  • Access headless REST endpoints for products, collections, checkout, and inventory synchronization.
  • Subscribe to real-time webhook events (order.created, order.paid, inventory.low) with HMAC signatures.
  • Benefit from global edge API execution with sub-40ms response times worldwide.
Prerequisites

Before configuring this feature, confirm that your store meets the following requirements:

Developer / Admin Account:Must have Administrator access to the store's Developer settings.
conversora.io/admin/developer-api
Headless Commerce REST API & Webhook Subscriptions
Click to enlarge

Interface view for this workflow.

1. Generating & Scoping API Tokens

Create API keys with the minimum required permissions necessary for your integration.

1

Navigate to Developer Hub

From the admin menu, select 'Settings' and click 'Developer & API'.

Path:Admin Sidebar → Settings → Developer & API
2

Create API Key

Click '+ Generate New Key', provide a descriptive label (e.g. 'Warehouse POS Scanner'), and select permitted scopes.

Path:Developer Workspace → Generate Key Modal
3

Copy Secret Key

Copy your API Secret Key immediately. For security, it is never displayed again.

Path:Key Modal → Copy Key → Save
Example REST API Request
curl -X GET https://conversora.io/api/v1/products \
  -H "Authorization: Bearer conv_live_abc123xyz" \
  -H "Content-Type: application/json"

Practical Business Scenarios

How leading merchants implement this functionality in daily operations:

Custom React Native Mobile App
Situation: A retail brand wants to launch a dedicated mobile app on Apple App Store and Google Play.
Best practice: Build the mobile app using our Headless Commerce API for product browsing and cart checkout, while managing all inventory and orders inside the standard Conversora dashboard.

Troubleshooting & Common Issues

Diagnose and resolve frequent failure points quickly:

Problem: API requests return 401 Unauthorized
Why this occurs: The API token is invalid, expired, or the Authorization header is missing the 'Bearer ' prefix.
Resolution: Verify the Authorization header is formatted as 'Bearer YOUR_TOKEN' and ensure the key has not been revoked in the Developer console.

Frequently Asked Questions

Are headless API endpoints available on all plans?

Read-only catalog endpoints are available on all plans. Full write access and webhook subscriptions are available on Growth and Enterprise plans.