Skip to content

Quickstart

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.

Everything in the CRM and the inbox belongs to a product. List the products the key may use:

Terminal window
curl https://api.motenya.app/v1/products \
-H "Authorization: Bearer $MOTENYA_KEY"
[{ "id": "01JD3Q…", "name": "Casa Verde", "businessType": "ecommerce", "modules": { "knowledgeBase": true, "ticketing": true } }]

List the customers of that product (needs crm:read):

Terminal window
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:

Terminal window
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.