Aller au contenu principal

API GraphQL

Le CRM expose une API GraphQL complète pour toutes les opérations CRUD.

Endpoint​

POST https://crm.spawnkit.ai/graphql

Authentification​

Ajoutez votre clé API dans le header :

Authorization: Bearer <votre-token-api>

Créez une clé API dans Paramètres → API & Webhooks.

Exemples​

Lister les entreprises​

query {
  companies {
    edges {
      node {
        name
        address { addressCity addressCountry }
        employees
      }
    }
  }
}

Créer un contact​

mutation {
  createPerson(data: {
    name: { firstName: "Marie", lastName: "Dupont" }
    city: "Lyon"
    emails: { primaryEmail: "marie@example.com" }
  }) {
    id
  }
}

Créer une opportunité​

mutation {
  createOpportunity(data: {
    name: "Isolation combles"
    stage: NEW
    amount: { amountMicros: 8500000000, currencyCode: EUR }
  }) {
    id
  }
}