Votre première connexion

Avant de commencer

L’API d’intégration connecte votre activité Kawlya à vos outils métier. Elle alimente les applications Kawlya pour Zapier et Make et peut aussi être utilisée directement depuis votre code.

1. Créer une clé API

Dans le tableau de bord, ouvrez Intégrations → API & Webhooks. Créez une clé et copiez-la immédiatement dans votre gestionnaire de secrets. Elle n’est affichée qu’une seule fois.

2. Vérifier la connexion

Remplacez la variable KAWLYA_API_KEY dans votre environnement. La clé identifie déjà votre entreprise : aucun identifiant de compte supplémentaire n’est nécessaire.

curl 'https://app.kawlya.com/api/integrations/v1/me' \
  -H "Authorization: Bearer $KAWLYA_API_KEY"

{
  "tenant": {
    "id": 42,
    "name": "Garage Dupont"
  }
}

3. S’abonner à un événement

Enregistrez l’adresse HTTPS publique de votre récepteur et les événements souhaités. L’exemple ci-dessous suit la création d’un rendez-vous.

curl 'https://app.kawlya.com/api/integrations/v1/webhooks' \
  -H "Authorization: Bearer $KAWLYA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://your-domain.example/webhooks/kawlya","events":["reservation.created"],"source":"custom"}'

4. Tester votre récepteur

Utilisez l’endpoint events/sample pour obtenir un exemple de données. Cette requête renvoie des exemples ; elle n’envoie pas de webhook à votre adresse. Vérifiez ensuite la signature des vraies livraisons et répondez en moins de 10 secondes.

curl 'https://app.kawlya.com/api/integrations/v1/events/sample?event=reservation.created&limit=1' \
  -H "Authorization: Bearer $KAWLYA_API_KEY"