API REST v1

    Documentation API

    Intégrez LemonCRM à votre stack. API REST, authentification JWT, webhooks temps réel et exemples de code.

    Démarrage rapide

    Base URL : https://api.lemoncrm.com/v1

    Format : JSON (Content-Type: application/json)

    Auth : Bearer token JWT dans le header Authorization

    Rate limit : 100 requêtes/minute par clé API

    // Exemple : lister les deals ouverts
    const response = await fetch('https://api.lemoncrm.com/v1/deals?status=open', {
      headers: {
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json'
      }
    });
    const { data } = await response.json();
    // data: [{ id, title, value, stage_id, contact_id, ... }]

    Endpoints

    Authentification

    Chaque requête API nécessite un token JWT obtenu via l'authentification. Les clés API sont gérées depuis les paramètres de votre organisation.

    POST /auth/login
    POST /auth/signup
    POST /auth/refresh

    Contacts

    CRUD complet sur vos contacts : création, lecture, mise à jour, suppression. Filtres par tags, entreprise et champs personnalisés.

    GET /contacts
    POST /contacts
    PATCH /contacts/:id
    DELETE /contacts/:id

    Deals

    Gérez vos opportunités commerciales : création, mise à jour d'étape, modification du montant et de la probabilité.

    GET /deals
    POST /deals
    PATCH /deals/:id
    PATCH /deals/:id/stage

    Pipeline & étapes

    Listez, créez et réorganisez vos pipelines et leurs étapes. Multi-pipeline supporté.

    GET /pipelines
    POST /pipelines
    GET /pipelines/:id/stages
    POST /pipelines/:id/stages

    Webhooks

    Recevez des notifications HTTP en temps réel : deal créé, étape changée, contact modifié, deal gagné.

    GET /webhooks
    POST /webhooks
    DELETE /webhooks/:id

    Organisations & rôles

    Gérez les membres de votre organisation et leurs rôles (admin, manager, rep).

    GET /org/members
    PATCH /org/members/:id/role
    DELETE /org/members/:id

    Besoin d'aide pour l'intégration ?

    Notre équipe technique peut vous accompagner sur votre intégration API.