Eventtia API V3

Ouverte par nature, faite pour s'intégrer.

Chaque opération de l'événement est un endpoint de l'API. Inscription, check-in, communications, matchmaking, analytique, paiements. Déploiements headless, webhooks en temps réel, authentification serveur à serveur. L'API événementielle la plus complète du secteur, en production sur connect.eventtia.com.

Consulter la documentation → Parlons-en
POST /api/v3/m2m-auth 
# Authentifie-toi, récupère un token Bearer, commence à intégrer
curl https://connect.eventtia.com/api/v3/m2m-auth \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "<your_client_id>",
    "client_secret": "<your_client_secret>"
  }'

# Réponse
{
  "access_token": "eyJhbGciOi...",
  "scope": "events:read events:write attendees:*",
  "expires_in": "2026-06-16T18:00:00Z",
  "token_type": "Bearer"
}

Des intégrations actives chez

Nike Cartier Sony Tiffany & Co. IWC Schaffhausen Van Cleef & Arpels Ralph Lauren Bioderma Pernod Ricard
Ce que ça rend possible

Quatre façons de s'intégrer, toutes ouvertes.

Eventtia est une infrastructure événementielle pensée API-first. Les clients opèrent depuis leurs propres systèmes, poussent leurs données en temps réel vers le reste de leur stack, automatisent des workflows au-dessus de la plateforme et, de plus en plus, laissent des agents IA faire les trois à la fois.

01 / Headless

Intègre Eventtia directement dans tes propres supports digitaux.

Les participants s'inscrivent sur ton site, ton application, ton parcours de paiement à tes couleurs, sans jamais voir Eventtia. Tout le moteur d'inscription vit derrière l'API. Nike a intégré Eventtia sur Nike.com, l'application iOS et l'application Android en moins de 90 jours, et fait aujourd'hui tourner plus de 5 000 événements par an depuis sa propre infrastructure.

POST /api/v3/events/{event_id}/attendees 
curl -X POST https://connect.eventtia.com/api/v3/events/12345/attendees \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "attendees",
      "attributes": {
        "email": "[email protected]",
        "first_name": "Maya",
        "last_name": "Khan",
        "attendee_type_id": 42
      }
    }
  }'
02 / Webhooks

Diffuse chaque événement vers le reste de ton stack, en temps réel.

Les webhooks au niveau du compte et au niveau de l'événement se déclenchent dès qu'un fait survient : création d'un participant, paiement confirmé, badge imprimé, réunion acceptée. Les webhooks de compte peuvent être filtrés sur des zones administratives précises. Ton CRM, ton entrepôt de données, ton tableau de bord BI et ton automatisation marketing reçoivent la même ligne au même instant.

POST /api/v3/account-webhooks 
curl -X POST https://connect.eventtia.com/api/v3/account-webhooks \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "target_url": "https://hooks.yourcompany.com/eventtia",
    "trigger": "attendee_created",
    "administrative_area_ids": [3, 7]
  }'
03 / Workflows sur mesure

Construis les automatisations que la plateforme ne fournit pas par défaut.

L'API expose les opérations à la granularité fine : approuver une inscription, mettre à jour les affectations d'ateliers, marquer un participant pour l'impression de son badge, envoyer une enquête. Combine-les dans les workflows dont ton équipe événementielle a réellement besoin. Les endpoints de traitement par lot gèrent le cas offline, quand la connexion tombe à l'entrée.

POST /api/v3/events/{event_id}/checkpoints/{checkpoint_id}/batch-checkin 
# Check-in par lot de 200 participants collectés hors ligne
curl -X POST "$URL/batch-checkin" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "checkpoints": [
      { "attendee_uuid": "abc-123", "checkpoint_id": 9,
        "action": "checkin", "action_at": "2026-05-22T09:14:11Z" },
      { "attendee_uuid": "def-456", "checkpoint_id": 9,
        "action": "checkin", "action_at": "2026-05-22T09:14:18Z" }
    ]
  }'
04 / Agents IA

Laisse les agents IA piloter la plateforme nativement.

Le premier serveur Model Context Protocol ouvert pour la gestion d'événements. Les agents découvrent ce qui est disponible, appellent les endpoints et orchestrent des workflows sans intégration sur mesure. Créer un événement, extraire des statistiques d'inscription, envoyer un rappel ciblé : c'est conversationnel, pas programmatique. Plus de détails dans la section MCP ci-dessous.

MCP mcp.eventtia.com 
# Dans la configuration de ton agent (Claude, ChatGPT, sur mesure)
{
  "mcpServers": {
    "eventtia": {
      "url": "https://mcp.eventtia.com",
      "headers": {
        "Authorization": "Bearer $TOKEN"
      }
    }
  }
}
La couverture de l'API

Chaque opération de l'événement, transformée en endpoint.

Plus de 110 endpoints sur toute la plateforme, regroupés comme les pense un intégrateur. Chacun documenté dans la référence de l'API, avec schémas de requête et de réponse, modes d'authentification, comportement du cache et exemples de code.

Événements

7 endpoints
  • POST /events
  • GET /events
  • GET /events/{id}
  • PATCH /events/{id}
  • GET /events/{id}/ticket-stats
  • GET /events/{id}/workshops-stats
  • GET /accounts/{uuid}/events

Participants

13 endpoints
  • POST /events/{id}/attendees
  • GET /events/{id}/attendees
  • GET /attendees/{id}
  • PATCH /attendees/{id}
  • POST /attendees/{id}/cancel
  • POST /attendees/{id}/print
  • … recherche par e-mail, archivage, mises à jour d'ateliers

Check-in et checkpoints

7 endpoints
  • POST /attendees/{id}/check-in
  • POST /checkpoints/{id}/check-in
  • POST /checkpoints/{id}/check-out
  • POST /batch-checkin
  • GET /checkpoints/{id}/check-ins
  • … jauge, types autorisés, synchronisation hors ligne

Conférences business matchmaking

25+ endpoints
  • GET /events/{id}/business-conferences
  • POST /meeting-requests
  • PATCH /meeting-requests/{id}/approve
  • GET /participants/{id}/agenda
  • GET /meetings/{id}/ics
  • … évaluations, listes noires, créneaux indisponibles, exports ICS

Ateliers et intervenants

22 endpoints
  • POST /workshops
  • POST /workshop-definitions
  • POST /attendees/{id}/workshops
  • GET /events/{id}/available-slots
  • … intervenants, catégories, définitions, exports

Paiements et options

7 endpoints
  • GET /events/{id}/purchase-items
  • GET /coupons/{id}
  • POST /coupons/{id}/validate
  • GET /attendees/{id}/purchase-items
  • … niveaux tarifaires, coupons de réduction, options par participant

Engagement Q&R · sondages

7 endpoints
  • GET /events/{id}/qa-sessions
  • POST /qa-sessions/{id}/questions
  • POST /qa-questions/{id}/like
  • GET /surveys/{id}
  • POST /surveys/{id}/answers

Webhooks

6 endpoints
  • POST /account-webhooks
  • POST /events/{id}/event-webhooks
  • GET /account-webhooks
  • DELETE /account-webhooks
  • … par déclencheur, filtrés par zone, idempotents

Utilisateurs, rôles, permissions

6 endpoints
  • POST /users
  • GET /users
  • GET /users/{id}/permissions
  • GET /roles
  • … SSO, archivage, permissions fines

Sponsors

3 endpoints
  • GET /events/{id}/sponsors
  • GET /sponsors/{id}
  • PATCH /sponsors/{id}

Géo et données de référence

6 endpoints
  • GET /countries
  • GET /regions
  • GET /cities
  • GET /timezones
  • … mis en cache 15 jours, publics

Authentification

3 modes
  • POST /m2m-auth serveur à serveur
  • POST /authenticate utilisateur backoffice
  • Tokens participant applications côté participant

Voir chaque endpoint dans la référence →

Authentification

Trois modes d'authentification, un par type d'intégration.

Les backends serveur à serveur, les actions des utilisateurs backoffice et les applications côté participant reçoivent chacun leur propre type de token. JWT sur toute l'API. Les tokens portent des scopes et des expirations, appliqués par l'API au niveau de chaque endpoint.

01 / Machine à machine

Identifiants client OAuth.

Pour les intégrations backend : synchronisation CRM, pipelines d'entrepôt de données, tâches planifiées. Échange un client_id et un client_secret contre un JWT, à joindre en Authorization: Bearer .... Les scopes déterminent les endpoints accessibles.

POST /api/v3/m2m-auth
02 / Utilisateur backoffice

JWT utilisateur.

Pour les outils qui agissent au nom d'un utilisateur Eventtia : scripts d'administration, extensions sur mesure du backoffice. Authentifie-toi par e-mail et mot de passe (ou SSO), et obtiens un JWT limité au rôle et aux permissions de cet utilisateur. Accès fin via le système de permissions.

POST /api/v3/authenticate
03 / Participant

Token participant.

Pour les applications côté participant : le participant inscrit consulte son agenda, envoie des demandes de rendez-vous, répond à un sondage, note une session. Le token est limité à la fiche du participant lui-même ; la délégation sponsor est prise en charge quand un sponsor gère plusieurs participants.

Émis via le parcours d'inscription
Exemples de code

De l'authentification au webhook en vingt lignes.

Cinq opérations courantes. Des endpoints réels. Copie, colle, remplace le token, et ça fonctionne. La référence complète inclut des variantes en JS/TS, Python, Ruby et Go.

# 1. Authentifie-toi en tant qu'intégration côté serveur
curl -X POST https://connect.eventtia.com/api/v3/m2m-auth \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "$CLIENT_ID",
    "client_secret": "$CLIENT_SECRET"
  }'

# Réponse : le JWT à utiliser comme token Bearer dans chaque autre appel
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "scope": "events:* attendees:* checkpoints:* webhooks:*",
  "expires_in": "2026-06-16T18:00:00Z",
  "token_type": "Bearer"
}
# 2. Crée un événement dans ton compte
curl -X POST https://connect.eventtia.com/api/v3/events \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "events",
      "attributes": {
        "name": "ICORI 2026",
        "event_uri": "icori-2026",
        "start_date": "2026-05-22T09:00:00",
        "end_date": "2026-05-22T18:00:00",
        "timezone": "America/Bogota"
      }
    }
  }'
# 3. Inscris un participant, avec des champs personnalisés en option
curl -X POST https://connect.eventtia.com/api/v3/events/12345/attendees \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "attendees",
      "attributes": {
        "email": "[email protected]",
        "first_name": "Maya",
        "last_name": "Khan",
        "attendee_type_id": 42,
        "custom_fields": {
          "company": "Atlas Research",
          "dietary_restrictions": "vegetarian"
        }
      }
    }
  }'
# 4. Abonne-toi aux événements attendee_created au niveau du compte
# Filtre en option sur des zones administratives précises (régions/marques)
curl -X POST https://connect.eventtia.com/api/v3/account-webhooks \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "target_url": "https://hooks.yourcompany.com/eventtia",
    "trigger": "attendee_created",
    "administrative_area_ids": [3, 7]
  }'

# Ton endpoint reçoit, pour chaque inscription :
# { "event_id": 12345, "attendee_id": 98765, "occurred_at": "..." }
# 5. Fais le check-in d'un participant à un checkpoint précis
curl -X POST https://connect.eventtia.com/api/v3/checkpoints/9/check-in \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "attendee_uuid": "8c5e2-..."
  }'

# Pour le hors ligne / par lot :
# POST /api/v3/checkpoints/9/batch-checkin
# avec un tableau de { attendee_uuid, checkpoint_id, action, action_at }
Webhooks

Des données en temps réel, prêtes dès le départ.

Les webhooks se déclenchent dès qu'un fait survient sur la plateforme. Tu peux t'abonner au niveau du compte (chaque événement du compte) ou par événement. Les abonnements de compte peuvent être filtrés sur des zones administratives précises. L'endpoint reçoit un payload JSON avec l'ID de l'entité et l'horodatage du fait ; récupère la fiche complète via l'API REST quand tu en as besoin.

Déclencheurs disponibles

  • attendee_created une nouvelle inscription arrive
  • attendee_updated le profil ou le statut change
  • attendee_paid un paiement est confirmé
  • attendee_checked_in le scan à l'entrée a réussi
  • meeting_request_created une demande de networking est envoyée
  • meeting_accepted une demande de networking est acceptée
  • workshop_registration_created inscription à une session
  • survey_answered une réponse est envoyée

Liste complète des déclencheurs et schémas de payload par déclencheur dans la référence de l'API.

Deux portées

Au niveau du compte

Un seul abonnement, déclenché pour chaque événement du compte qui correspond au déclencheur. Le filtre optionnel administrative_area_ids restreint à des régions, marques ou unités métier précises.

POST /api/v3/account-webhooks

Au niveau de l'événement

Abonnement limité à un seul événement. Utile pour les événements à forte volumétrie ou les intégrations ponctuelles. Nécessite que les webhooks soient activés dans les paramètres de l'événement.

POST /api/v3/events/{event_id}/event-webhooks
Pour les agents IA

Le premier serveur MCP ouvert pour la gestion d'événements.

Model Context Protocol est le standard émergent qui régit comment les agents IA découvrent et appellent des outils. Eventtia expose la plateforme comme un serveur MCP, si bien que Claude, ChatGPT, des agents sur mesure et ce qui viendra ensuite peuvent piloter des événements nativement : créer un événement, extraire des statistiques d'inscription, envoyer un rappel ciblé, orchestrer des workflows, sans travail d'intégration sur mesure pour chaque modèle.

01
Un seul protocole, tous les agents. Les agents découvrent les outils disponibles de la même façon qu'ils découvrent Slack, GitHub ou tout autre serveur MCP. Tes clients n'écrivent pas d'adaptateur par modèle.
02
Conversationnel, pas programmatique. « Organise un atelier de 200 personnes le 12 juin, invite les participants de l'événement de mai, et relance jeudi ceux qui n'ont pas répondu. » L'agent traduit ça dans les bons appels API.
03
Même authentification, même modèle de données. Le serveur MCP s'appuie sur l'API REST. Mêmes tokens, mêmes scopes, mêmes permissions. Ce qu'un agent peut faire est exactement ce que peut faire un utilisateur humain avec ce même token.

Plus de détails sur l'approche agentique dans l'article de blog sur le logiciel agentique événementiel. Une page dédiée au MCP est en préparation : elle arrive bientôt.

En production

Nike fait tourner plus de 5 000 événements par an sur l'API Eventtia.

Une infrastructure headless sur Nike.com, l'application iOS et l'application Android.

La direction informatique mondiale de Nike a intégré Eventtia comme infrastructure événementielle sur trois supports digitaux. Les participants s'inscrivent sur des supports à la marque Nike et ne voient jamais Eventtia. Le moteur d'inscription, le parcours de paiement, l'historique de check-in, le reporting : tout est derrière l'API, tout sous la marque Nike. L'intégration a été bouclée en moins de 90 jours. Le programme fait aujourd'hui tourner plus de 5 000 événements par an.

5 000+ événements par an
3 supports digitaux
< 90 jours jusqu'à la mise en service
Lire l'étude de cas Nike →
Pour les développeurs

Documentation, environnements, support : aucune boîte noire.

Référence

Documentation complète de l'API.

Chaque endpoint avec ses schémas de requête et de réponse, des exemples réels dans plusieurs langages, un essai en direct dans la page (via ReadMe). Spécification OpenAPI disponible pour générer des clients.

docs-connect-api-v3.eventtia.com →
Prête pour les LLM

Indexée pour les agents IA.

La documentation fournit un index llms.txt en Markdown, avec les définitions OpenAPI par endpoint. Les agents peuvent découvrir toute la couverture de façon programmatique et appeler les endpoints avec un contexte structuré.

Voir llms.txt →
Support

Une équipe dédiée aux intégrations enterprise.

Pour les déploiements headless à la Nike et les configurations multi-régions complexes, un ingénieur d'intégration Eventtia rejoint le projet depuis la revue d'architecture jusqu'à la mise en service. Pas une file de tickets.

Parlons-en →
Statut

L'état de la plateforme en temps réel.

Disponibilité de l'API, historique des incidents et santé par composant sur status.eventtia.com. Abonne-toi par e-mail ou RSS pour recevoir les notifications d'incidents.

status.eventtia.com →
FAQ

Ce que demandent toujours les responsables d'intégration.

Quel est le SLA de disponibilité de l'API ?

La disponibilité de l'API suit le même SLA que la plateforme dans son ensemble. Les incidents de haute priorité (panne totale ou tout ce qui bloque un événement en direct) ont un objectif de réponse à 15 minutes et de résolution à 1 heure. Le statut en direct et l'historique des incidents sont sur status.eventtia.com ; le SLA complet figure sur la page du SLA.

Comment l'API est-elle versionnée ?

Le versionnage se fait dans l'URL. La version de production actuelle est /api/v3/. Les changements incompatibles passent par une nouvelle version ; la précédente reste disponible avec des délais de dépréciation documentés. Les ajouts sans rupture (nouveaux endpoints, nouveaux champs optionnels) sont livrés dans la version en cours sans préavis.

Y a-t-il des limites de débit ?

Oui, appliquées par token. Le palier par défaut absorbe confortablement les charges d'intégration classiques ; les intégrations enterprise (à l'échelle de Nike, plus de 5 000 événements par an) reçoivent des limites relevées dans le cadre du déploiement. Les réponses de limitation incluent les en-têtes standards X-RateLimit-Remaining et Retry-After, de quoi alimenter ta logique de nouvelle tentative.

Où l'API est-elle hébergée ?

Eventtia opère des entités juridiques en Europe avec une infrastructure disponible dans l'UE comme aux États-Unis. Même API, mêmes fonctionnalités, du côté de l'Atlantique qui correspond à tes exigences de conformité. La résidence des données se choisit au niveau du compte pendant l'onboarding. Le traitement conforme au RGPD s'applique dans les deux régions.

Quelle authentification l'API utilise-t-elle ?

JWT sur toute l'API. Trois types de tokens : machine à machine (identifiants client OAuth, pour les intégrations côté serveur), utilisateur (pour les outils agissant au nom d'un utilisateur Eventtia) et participant (pour les applications côté participant). Les tokens portent des scopes et des expirations, appliqués par l'API au niveau de chaque endpoint. Voir la section Authentification ci-dessus pour le modèle complet.

Les webhooks sont-ils signés ?

Oui. Chaque envoi de webhook inclut une signature HMAC dans les en-têtes de la requête, calculée avec un secret partagé. Vérifie la signature côté serveur avant de faire confiance au payload. La protection contre le rejeu passe par un horodatage du fait combiné à un nonce signé.

Peut-on tester dans un bac à sable avant la mise en production ?

Oui. Les intégrations enterprise reçoivent un environnement de test dédié, avec une copie du modèle de données de production et la même couverture d'API. Utile pour les tests d'intégration en CI, les migrations de schéma et les répétitions de changements de déploiement avant qu'ils ne touchent de vrais événements.

Existe-t-il une collection Postman ou un SDK ?

La spécification OpenAPI est publiée avec la documentation, ce qui permet de générer des clients dans n'importe quel langage avec des outils standards (openapi-generator, entre autres). Une collection Postman est disponible sur demande. Aucun SDK propriétaire n'est fourni par défaut, car la plupart des équipes d'intégration préfèrent générer le client qui correspond à leur propre code.

Quel est le lien entre le serveur MCP et l'API REST ?

Le serveur MCP s'appuie sur l'API REST comme couche de traduction. Il expose les opérations de l'API aux agents IA au format Model Context Protocol. Le modèle d'authentification est le même (tokens Bearer) ; les permissions sont les mêmes (ce qu'un agent peut faire est exactement ce que peut faire, via REST, un utilisateur avec ce même token). Plus de détails dans la section MCP ci-dessus ; une page dédiée arrive bientôt.

À qui appartiennent les données accessibles via l'API ?

À toi. Eventtia est le sous-traitant des données ; tu es le responsable du traitement. L'API n'ajoute aucune condition de partage ou de conservation des données au-delà de ce que prévoit déjà le contrat principal. Les données complètes de participants, de transactions et d'inscription s'exportent à tout moment via l'API. La base légale figure dans la politique de confidentialité.

Construis avec l'API. Parle à un vrai ingénieur.

Pour les déploiements headless à l'échelle de Nike et les configurations multi-régions complexes, un ingénieur d'intégration Eventtia rejoint ton équipe depuis la revue d'architecture jusqu'à la mise en service. Trente minutes, sans présentation, des réponses réelles à des questions réelles.

Consulter la documentation → Parlons-en