# Fiche connecteur Grain
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## Grain
URL : https://get-bruno.com/features/connectors/grain
Référence texte : https://get-bruno.com/features/connectors/grain/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Organisation du travail
Description : Grain sert à enregistrer des réunions, à récupérer leurs transcriptions et à gérer le partage des enregistrements. Le connecteur expose aussi la lecture des métadonnées, des listes de réunions, des équipes et des utilisateurs, ainsi que des déclencheurs sur les événements liés aux highlights, stories et recordings.
Authentification : OAuth
Présentation : Grain sert à enregistrer des réunions, à récupérer leurs transcriptions et à gérer le partage des enregistrements. Le connecteur expose aussi la lecture des métadonnées, des listes de réunions, des équipes et des utilisateurs, ainsi que des déclencheurs sur les événements liés aux highlights, stories et recordings.
Usage : Récupérer la transcription d’un appel client
Exemple de demande : Je veux obtenir la transcription de l’appel avec Atelier Martin pour préparer un compte-rendu et vérifier les prochaines étapes.
Résultat attendu : La transcription complète est renvoyée dans le format choisi, ou un texte brut si demandé.
À préciser : Identifiant de l’enregistrement ; Format souhaité pour la transcription
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/grain/actions/get-transcript
Usage : Retrouver l’enregistrement d’une réunion commerciale
Exemple de demande : Je veux lister les enregistrements contenant Acme dans le titre pour retrouver la réunion de suivi commerciale.
Résultat attendu : Une liste d’enregistrements correspondants est renvoyée avec leurs identifiants et métadonnées utiles.
À préciser : Mot-clé de titre ou filtre métier ; Période approximative si nécessaire
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/grain/actions/list-recordings
Usage : Partager un compte-rendu avec une équipe
Exemple de demande : Je veux partager l’enregistrement du point projet avec l’équipe Pipedream pour que les responsables puissent le consulter.
Résultat attendu : Le partage est appliqué au niveau de l’utilisateur ou de l’équipe ciblée, puis une confirmation de succès est renvoyée.
À préciser : Identifiant de l’enregistrement ; Type de cible, utilisateur ou équipe ; Identifiant de la cible
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/grain/actions/manage-recording-sharing
Limites propres au service : Le téléchargement du média n’est possible que pour les enregistrements dont le média est traité. La transcription et le média sont deux objets distincts, il faut choisir la bonne ressource. Le partage exige de résoudre les identifiants de l’enregistrement et de la cible. Les déclencheurs documentés portent sur highlights, stories et recordings, pas sur d’autres objets.
Vocabulaire français : Télécharger l’enregistrement — Télécharge le fichier média d’un enregistrement Grain et l’écrit dans File Stash. (https://pipedream.com/apps/grain/actions/download-recording)
Vocabulaire français : Obtenir un enregistrement — Récupère les métadonnées d’un enregistrement précis à partir de son identifiant. (https://pipedream.com/apps/grain/actions/get-recording)
Vocabulaire français : Obtenir la transcription — Récupère la transcription complète d’un enregistrement Grain dans le format demandé. (https://pipedream.com/apps/grain/actions/get-transcript)
Vocabulaire français : Lister les types de réunion — Liste les types de réunion configurés dans l’espace Grain. (https://pipedream.com/apps/grain/actions/list-meeting-types)
Vocabulaire français : Lister les enregistrements — Liste les enregistrements Grain avec filtres possibles sur la période, le titre, les participants, l’équipe ou le type de réunion. (https://pipedream.com/apps/grain/actions/list-recordings)
Vocabulaire français : Lister les équipes — Liste les équipes de l’espace Grain pour résoudre un identifiant d’équipe. (https://pipedream.com/apps/grain/actions/list-teams)
Vocabulaire français : Lister les utilisateurs — Liste les utilisateurs de l’espace Grain pour résoudre un identifiant d’utilisateur. (https://pipedream.com/apps/grain/actions/list-users)
Vocabulaire français : Gérer le partage d’un enregistrement — Partage ou retire le partage d’un enregistrement avec un utilisateur ou une équipe. (https://pipedream.com/apps/grain/actions/manage-recording-sharing)
Vocabulaire français : Mettre à jour un enregistrement — Renomme un enregistrement et ajoute ou retire des étiquettes. (https://pipedream.com/apps/grain/actions/update-recording)
Vocabulaire français : Nouveau highlight — Déclenche un événement quand un highlight est ajouté. (https://pipedream.com/apps/grain/triggers/new-highlight-instant)
Vocabulaire français : Highlight supprimé — Déclenche un événement quand un highlight est supprimé. (https://pipedream.com/apps/grain/triggers/removed-highlight-instant)
Vocabulaire français : Highlight mis à jour — Déclenche un événement quand un highlight est mis à jour. (https://pipedream.com/apps/grain/triggers/updated-highlight-instant)
Vocabulaire français : Nouvel enregistrement — Déclenche un événement quand un enregistrement est ajouté. (https://pipedream.com/apps/grain/triggers/new-recording-instant)
Vocabulaire français : Enregistrement supprimé — Déclenche un événement quand un enregistrement est supprimé. (https://pipedream.com/apps/grain/triggers/removed-recording-instant)
Vocabulaire français : Enregistrement mis à jour — Déclenche un événement quand un enregistrement est mis à jour. (https://pipedream.com/apps/grain/triggers/updated-recording-instant)
Vocabulaire français : Nouvelle story — Déclenche un événement quand une story est ajoutée. (https://pipedream.com/apps/grain/triggers/new-story-instant)
Vocabulaire français : Story supprimée — Déclenche un événement quand une story est supprimée. (https://pipedream.com/apps/grain/triggers/removed-story-instant)
Vocabulaire français : Story mise à jour — Déclenche un événement quand une story est mise à jour. (https://pipedream.com/apps/grain/triggers/updated-story-instant)
- action : Download Recording — Downloads a Grain recording's media file (video or audio) and writes it to File Stash, returning filePath , filename , and contentType . Only recordings with processed media have a downloadable file — check media_type ( video or audio , not transcript ) from List Recordings or Get Recording first. Use Get Transcript instead if you only need the spoken content, not the media file itself. Example: recordingId: "8a089fcb-0961-4393-8da2-f0db5f8cfd79" downloads the file and returns {"filePath": "/tmp/grain-recording-8a089fcb-....mp4", "filename": "grain-recording-8a089fcb-....mp4", "contentType": "video/mp4"} . See the documentation (https://pipedream.com/apps/grain/actions/download-recording)
- action : Get Recording — Fetches a specific recording by its ID from Grain, returning its metadata (title, times, URL, tags, teams, meeting type). Enable the optional include props to add highlights, participants, AI action items, AI summary, calendar event, HubSpot data, or screenshares to the response. Use List Recordings to find recording IDs, and Get Transcript to fetch the full transcript. Example: recordingId: "pppp6666-qq77-rr88-ss99-tttt00000000" with aiSummary: true returns the recording's metadata plus {"ai_summary": {"text": "..."}} . See the documentation (https://pipedream.com/apps/grain/actions/get-recording)
- action : Get Transcript — Fetches the full transcript of a Grain recording. The json format returns structured segments with speaker, participant ID, start/end times in milliseconds, and text; txt , vtt , and srt return plain text or subtitle formats. Use List Recordings to find recording IDs; use Get Recording for the recording's metadata instead of its transcript. Example: recordingId: "pppp6666-qq77-rr88-ss99-tttt00000000" with format: "txt" returns plain text like "Speaker 1: Thanks for joining today..." . See the documentation (https://pipedream.com/apps/grain/actions/get-transcript)
- action : List Meeting Types — Lists the meeting types configured in your Grain workspace (id, name, scope), where scope is internal or external . Use this to understand how recordings are categorized, or to resolve a meeting type's ID for filtering. Example: returns [{"id": "e8b894a9-7ecf-4330-a282-527c085618fd", "name": "Sales", "scope": "external"}, {"id": "815747d1-9e25-40f6-a3b8-e1908e25151e", "name": "1:1s", "scope": "internal"}] . See the documentation (https://pipedream.com/apps/grain/actions/list-meeting-types)
- action : List Recordings — Lists Grain recordings, optionally filtered by start datetime range (ISO8601), title search, participant scope, team, or meeting type. Automatically paginates and returns up to Max Results recordings. Use this to find recording IDs for Get Recording and Get Transcript . Example: titleSearch: "Acme" returns recordings like [{"id": "pppp6666-qq77-rr88-ss99-tttt00000000", "title": "Acme Renewal Call", "start_datetime": "2026-01-05T15:00:00Z", "media_type": "video", ...}] . Pass fields to return only the fields you need instead of the full object. See the documentation (https://pipedream.com/apps/grain/actions/list-recordings)
- action : List Teams — Lists the teams in your Grain workspace (id, name). Use this to resolve a team's ID before sharing a recording with it via Manage Recording Sharing . Example: returns [{"id": "a414c333-c9fe-4fdc-9131-fb31796699b2", "name": "Pipedream"}] . See the documentation (https://pipedream.com/apps/grain/actions/list-teams)
- action : List Users — Lists the users in your Grain workspace (id, name, email). Use this to resolve a user's ID before sharing a recording with them via Manage Recording Sharing , or to identify who's who when reviewing recording participants. Example: returns [{"id": "d91b7ed0-a149-425c-9623-0664148e4fc1", "name": "Danny Archer", "email": "darcher@pipedream.com"}] . See the documentation (https://pipedream.com/apps/grain/actions/list-users)
- action : Manage Recording Sharing — Shares or unshares a recording with a specific user or team. Use List Recordings to find the recording's ID, and List Users or List Teams to resolve the target's ID. Set operation to share to grant access or unshare to revoke it, and targetType to user or team . Example: recordingId: "pppp6666-qq77-rr88-ss99-tttt00000000", operation: "share", targetType: "user", targetId: "d91b7ed0-a149-425c-9623-0664148e4fc1" shares the recording with that user and returns {"success": true} . See the documentation (https://pipedream.com/apps/grain/actions/manage-recording-sharing)
- action : Update Recording — Renames a recording and/or adds and removes tags on it. All fields are optional — pass only what you want to change. Use List Recordings first to find the recording's ID. Example: to retitle a recording and tag it, pass title and addTags: ["qa-verified"] together. See the documentation (https://pipedream.com/apps/grain/actions/update-recording)
- trigger : New Highlight (Instant) — Emit new event when a highlight is added. See the documentation (https://pipedream.com/apps/grain/triggers/new-highlight-instant)
- trigger : New Highlight Removed (Instant) — Emit new event when a highlight is removed. See the documentation (https://pipedream.com/apps/grain/triggers/removed-highlight-instant)
- trigger : New Highlight Updated (Instant) — Emit new event when a highlight is updated. Deduplicates retried webhook deliveries of the same update; each distinct update still emits. See the documentation (https://pipedream.com/apps/grain/triggers/updated-highlight-instant)
- trigger : New Recording (Instant) — Emit new event when a recording is added. See the documentation (https://pipedream.com/apps/grain/triggers/new-recording-instant)
- trigger : New Recording Removed (Instant) — Emit new event when a recording is removed. See the documentation (https://pipedream.com/apps/grain/triggers/removed-recording-instant)
- trigger : New Recording Updated (Instant) — Emit new event when a recording is updated. Deduplicates retried webhook deliveries of the same update; each distinct update still emits. See the documentation (https://pipedream.com/apps/grain/triggers/updated-recording-instant)
- trigger : New Story (Instant) — Emit new event when a story is added. See the documentation (https://pipedream.com/apps/grain/triggers/new-story-instant)
- trigger : New Story Removed (Instant) — Emit new event when a story is removed. See the documentation (https://pipedream.com/apps/grain/triggers/removed-story-instant)
- trigger : New Story Updated (Instant) — Emit new event when a story is updated. Deduplicates retried webhook deliveries of the same update; each distinct update still emits. See the documentation (https://pipedream.com/apps/grain/triggers/updated-story-instant)