Quickstart
1. Create a key
Section titled “1. Create a key”In the Motenya admin, open Settings → API & MCP and create a key. Pick what it may do (its scopes) and which products it may use. The secret (mtk_…) is shown once; store it like a password.
2. Find your product
Section titled “2. Find your product”Everything in the CRM and the inbox belongs to a product. List the products the key may use:
curl https://api.motenya.app/v1/products \ -H "Authorization: Bearer $MOTENYA_KEY"[{ "id": "01JD3Q…", "name": "Casa Verde", "businessType": "ecommerce", "modules": { "knowledgeBase": true, "ticketing": true } }]3. Read and write
Section titled “3. Read and write”List the customers of that product (needs crm:read):
curl "https://api.motenya.app/v1/products/01JD3Q…/clients?first=10" \ -H "Authorization: Bearer $MOTENYA_KEY"Record a customer from your own system, by its id there (needs crm:write). Running it again updates the same record:
curl -X PUT "https://api.motenya.app/v1/products/01JD3Q…/sync/clients/erp/C-1042" \ -H "Authorization: Bearer $MOTENYA_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Atelier Nord SRL", "vatNumber": "RO12345678" }'Next: the conventions every endpoint follows, and the sync guide for keeping the CRM in step with another system.