Créer une annotation avec l'API Mixpanel
Crée une annotation, une note affichée à une date sur les graphiques du projet, comme le lancement d'une campagne. Le compte de service doit avoir le rôle Analyst ou supérieur sur le projet.
- Identifiant
- mixpanel_create_annotation
L'appel
POST https://connect.reportei.com/api/tools/mixpanel_create_annotation/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"project_id": 1,
"date": "<date>",
"description": "<description>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| project_id | integer | Oui | Id of the project, sent as a number: a key of results.projects in List projects, or the number after /project/ in the URL of Mixpanel. |
| date | string | Oui | Date and time of the annotation as YYYY-MM-DD HH:mm:ss, for example 2026-10-01 09:00:00. |
| description | string | Oui | Text shown on the charts. |
Connexions possibles
Votre client connecte son compte Mixpanel une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Identifiant et mot de passe
Votre client saisit les identifiants de l'app sur un écran de Connect, ou votre système les envoie avec POST /api/customer-toolkits, sans écran.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/mixpanel_create_annotation. Il devient la définition de tool de votre agent sans conversion.
Autres tools Mixpanel
- Lister les projetsGETRenvoie, dans results, le compte de service lui-même ainsi que les organisations, projets et workspaces auxquels il a accès, chacun indexé par id. Les clés de results.projects sont le project_id que demandent les autres outils, et results.workspaces contient le workspace_id des projets qui utilisent des data views.
- Obtenir un rapport enregistréGETRenvoie les données d'un rapport Insights ou Funnels enregistré, calculées avec la plage de dates et les filtres enregistrés dans le rapport. Compte dans la limite de la Query API de 60 requêtes par heure.
- Lister les noms d'événementsGETListe les noms des événements les plus courants du projet sur les 31 derniers jours, à utiliser comme arguments event des autres outils. Compte dans la limite de la Query API de 60 requêtes par heure.
- Lister les propriétés d'événementGETListe les noms de propriété les plus courants d'un événement, pour construire les expressions on et where d'Obtenir un rapport de rétention. Compte dans la limite de la Query API de 60 requêtes par heure.
- Obtenir les décomptes d'événementsGETRenvoie, période par période, le décompte total, unique ou moyen d'un ou plusieurs événements entre deux dates. Compte dans la limite de la Query API de 60 requêtes par heure.
- Obtenir le rapport de rétentionGETRenvoie, pour chaque date de cohorte, combien d'utilisateurs sont entrés dans la cohorte (first) et combien sont revenus à chaque intervalle suivant (counts). Compte dans la limite de la Query API de 60 requêtes par heure.
- Lister les cohortesPOSTListe les cohortes enregistrées du projet avec id, nom, nombre d'utilisateurs, description, date de création et visibilité. Compte dans la limite de la Query API de 60 requêtes par heure.
- Rechercher des profilsPOSTRenvoie les profils utilisateurs qui correspondent à une expression where, une cohorte ou une liste de distinct_ids, avec leurs propriétés. Une page contient jusqu'à page_size profils : pour la suivante, répétez l'appel avec les mêmes filtres, le session_id de la réponse et page plus un. Compte dans la limite de la Query API de 60 requêtes par heure.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
