Desarrolladores · Empezar
Conecta meruma con tus sistemas y tu IA
La API REST de meruma, los webhooks, las apps sin código y la IA por MCP. Todo lo que necesitas para conectar meruma con tus herramientas.
Tres caminos
- La API y los webhooks. REST y OAuth 2 para tus sistemas, con avisos firmados cuando algo cambia. Es la que usan n8n, Zapier y Make. Empieza por Autenticación.
- Tu propia IA, por MCP. Conecta Claude, ChatGPT u otra IA a meruma: busca, lee y anota como tú, con tus permisos. Ve a Conecta tu IA.
- Uma, dentro de meruma. La asistente del equipo ya está en la app: responde, busca y prepara cambios, sin conectar nada. Lo explica el centro de ayuda.
Qué puedes hacer con la API
- Contactos: leerlos y crearlos, con «crear o actualizar» por correo o teléfono para no duplicar.
- Fichas: crearlas, moverlas de etapa, ponerles etiquetas y montos.
- Notas: leer y agregar notas en contactos y fichas.
- Avisos en tiempo real: un webhook cuando se crea o cambia un contacto o una ficha.
La API está incluida en todos los planes. La base de todas las rutas es https://api.meruma.app/v1, y la referencia de la API tiene cada endpoint con sus parámetros y ejemplos.
Tu primer pedido
- En meruma, ve a Integraciones › Para desarrolladores › Crear app. Elige los permisos y copia el ID y el secreto de la app. Puede crearla quien tenga Integraciones en su rol.
- Pide un token con el ID y el secreto. Dura una hora.
- Úsalo en el encabezado
Authorizationde cada pedido.
# 1. El token
curl -u "$CLIENT_ID:$CLIENT_SECRET" \
-d grant_type=client_credentials \
https://api.meruma.app/oauth/token
# 2. Quién eres: la organización, la app y sus permisos
curl https://api.meruma.app/v1/me \
-H "Authorization: Bearer $ACCESS_TOKEN"
Por dónde seguir
- Autenticación: las dos formas de conectar y los permisos.
- Límites y errores: cuántos pedidos puedes hacer y cómo leer un error.
- Webhooks: los cinco eventos y cómo llegan.
- n8n: conectar sin escribir código.
Revisado el