# Fiche connecteur Beehiiv
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.

## Beehiiv
URL : https://get-bruno.com/features/connectors/beehiiv
Référence texte : https://get-bruno.com/features/connectors/beehiiv/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Marketing
Description : Beehiiv est une plateforme de newsletter. Le catalogue expose des actions pour gérer des abonnés, des publications, des champs personnalisés, des segments et des métriques agrégées de posts.
Authentification : API key
Présentation : Beehiiv est une plateforme de newsletter. Le catalogue expose des actions pour gérer des abonnés, des publications, des champs personnalisés, des segments et des métriques agrégées de posts.
Usage : Ajouter un abonné à la publication
Exemple de demande : Je veux ajouter l'abonné marie.durand@example.com à la publication Atelier Martin avec le champ Ville = Lyon.
Résultat attendu : Un nouvel abonné est préparé pour la publication ciblée, avec les champs fournis si la structure attendue est disponible.
À préciser : L'adresse email de l'abonné. ; Le nom du champ personnalisé ou la donnée à associer, par exemple Ville = Lyon. ; L'identifiant de la publication à partir de ses informations.
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/beehiiv/actions/add-subscriber ; https://pipedream.com/apps/beehiiv/actions/get-publication-info ; https://pipedream.com/apps/beehiiv/actions/list-custom-fields
Usage : Créer un brouillon de newsletter
Exemple de demande : Je veux créer un brouillon de post pour la newsletter Compte-rendu client avec le texte de l'annonce.
Résultat attendu : Un post est créé comme brouillon par défaut, avec le contenu HTML fourni si la publication et les droits sont corrects.
À préciser : Le contenu HTML du post. ; Le nom ou le sujet de la newsletter, par exemple Compte-rendu client. ; L'identifiant de la publication.
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/beehiiv/actions/create-post ; https://pipedream.com/apps/beehiiv/actions/get-publication-info
Usage : Chercher un abonné et mettre à jour son état
Exemple de demande : Je veux retrouver l'abonné marie.durand@example.com puis le marquer comme non abonné si nécessaire.
Résultat attendu : L'abonné est retrouvé par email ou identifiant, puis ses champs ou son statut peuvent être mis à jour.
À préciser : L'email ou l'identifiant de l'abonné. ; L'identifiant de la publication. ; La modification attendue, par exemple une mise à jour de champ ou un désabonnement.
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/beehiiv/actions/get-subscriber ; https://pipedream.com/apps/beehiiv/actions/search-subscribers ; https://pipedream.com/apps/beehiiv/actions/update-subscriber ; https://pipedream.com/apps/beehiiv/actions/get-publication-info
Limites propres au service : La plupart des actions demandent l'identifiant de publication obtenu au préalable. La création d'abonné peut nécessiter de connaître les champs personnalisés disponibles. Le post est créé en brouillon par défaut si aucun statut confirmé n'est fourni. Les métriques de post sont agrégées et ne remplacent pas un détail ligne par ligne sur les abonnés.
Vocabulaire français : Ajouter un abonné — Crée un nouvel abonné pour une publication et permet de réactiver un ancien désabonnement. (https://pipedream.com/apps/beehiiv/actions/add-subscriber)
Vocabulaire français : Créer un post — Crée un nouveau post de newsletter, généralement en brouillon par défaut. (https://pipedream.com/apps/beehiiv/actions/create-post)
Vocabulaire français : Créer un abonné — Crée un nouvel abonné. (https://pipedream.com/apps/beehiiv/actions/create-subscriber)
Vocabulaire français : Obtenir les statistiques d'un post — Retourne des statistiques agrégées sur l'ensemble des posts, comme les ouvertures et les clics. (https://pipedream.com/apps/beehiiv/actions/get-post-analytics)
Vocabulaire français : Obtenir les informations de la publication — Retourne les détails de la publication courante, dont son nom, son URL et son identifiant. (https://pipedream.com/apps/beehiiv/actions/get-publication-info)
Vocabulaire français : Obtenir un abonné — Retourne les détails complets d'un abonné à partir de son identifiant ou de son email. (https://pipedream.com/apps/beehiiv/actions/get-subscriber)
Vocabulaire français : Lister toutes les publications — Retourne la liste de toutes les publications du compte. (https://pipedream.com/apps/beehiiv/actions/list-all-publications)
Vocabulaire français : Lister les champs personnalisés — Retourne le schéma des champs personnalisés définis pour les abonnés d'une publication. (https://pipedream.com/apps/beehiiv/actions/list-custom-fields)
Vocabulaire français : Lister les posts — Retourne les posts d'une publication avec leur statut, audience, plateforme, titre, date et URL. (https://pipedream.com/apps/beehiiv/actions/list-posts)
Vocabulaire français : Lister les segments — Retourne les segments d'abonnés d'une publication pour comprendre leur organisation. (https://pipedream.com/apps/beehiiv/actions/list-segments)
Vocabulaire français : Rechercher des abonnés — Recherche et filtre des abonnés d'une publication, notamment par email ou par statut. (https://pipedream.com/apps/beehiiv/actions/search-subscribers)
Vocabulaire français : Mettre à jour un abonné — Met à jour les champs d'un abonné existant ou le désabonne. (https://pipedream.com/apps/beehiiv/actions/update-subscriber)
- action : Add Subscriber — Create a new subscriber for a publication. Use List Custom Fields to discover available custom field names before passing customFields . Use Get Publication Info to get the publication ID. Set reactivateExisting: true to re-subscribe someone who previously unsubscribed. See the documentation (https://pipedream.com/apps/beehiiv/actions/add-subscriber)
- action : Create Post — Create a new post (newsletter draft). Pass HTML content in the content parameter. The post is created as a draft by default — set status: "confirmed" to publish immediately. Use content tags to categorize the post. Use Get Publication Info to get the publication ID. See the documentation (https://pipedream.com/apps/beehiiv/actions/create-post)
- action : Create Subscriber — Create a new subscriber. See docs (https://pipedream.com/apps/beehiiv/actions/create-subscriber)
- action : Get Post Analytics — Get aggregated analytics across all posts — open rates, click rates, unsubscribes, etc. Filter by audience (free/premium), platform (web/email), or content tags. Returns metrics: recipients, delivered, opens, unique_opens, open_rate, clicks, unique_clicks, click_rate, unsubscribes, spam_reports. Use List Posts to see individual post details. Use Get Publication Info to get the publication ID. See the documentation (https://pipedream.com/apps/beehiiv/actions/get-post-analytics)
- action : Get Publication Info — Get details about the current beehiiv publication, including name, URL, and subscriber stats. Call this first to get the publicationId needed by all other tools. If you have multiple publications, pass the publicationId — otherwise the first publication is returned. Returns the publication name, description, URL, creation date, and subscriber count. See the documentation (https://pipedream.com/apps/beehiiv/actions/get-publication-info)
- action : Get Subscriber — Get full details for a single subscriber by ID or email. Use expand to include stats (open/click rates), custom field values, or referral data. Either subscriptionId or email must be provided. Use Search Subscribers to find subscriber IDs. Use Get Publication Info to get the publication ID. See the documentation (https://pipedream.com/apps/beehiiv/actions/get-subscriber)
- action : List All Publications — Get a list of all your publications. See docs (https://pipedream.com/apps/beehiiv/actions/list-all-publications)
- action : List Custom Fields — Schema discovery — list all custom fields defined for subscribers in a publication. Use this before Create Subscriber or Update Subscriber to know what custom fields are available and their expected types. Use Get Publication Info to get the publication ID. See the documentation (https://pipedream.com/apps/beehiiv/actions/list-custom-fields)
- action : List Posts — List posts (newsletter issues) for a publication. Filter by status, audience, platform, or content tags. Returns post titles, dates, status, and URLs. Use Get Publication Info to get the publication ID. Use Get Post Analytics for aggregate performance metrics across posts. See the documentation (https://pipedream.com/apps/beehiiv/actions/list-posts)
- action : List Segments — List subscriber segments for a publication. Segments are pre-defined subscriber groups (dynamic rules, static lists, or manual selections). Use this for discovery — to understand how subscribers are organized. Use Get Publication Info to get the publication ID. See the documentation (https://pipedream.com/apps/beehiiv/actions/list-segments)
- action : Search Subscribers — Search and filter subscribers for a publication. Use email for exact email lookup, or combine status and tier filters to narrow results. Use Get Publication Info to get the publication ID. For full details on a single subscriber (with stats, custom fields, referrals), use Get Subscriber instead. Use List Custom Fields to discover available custom field names. See the documentation (https://pipedream.com/apps/beehiiv/actions/search-subscribers)
- action : Update Subscriber — Update an existing subscriber's fields or unsubscribe them. Use Search Subscribers or Get Subscriber to find the subscription ID first. Use List Custom Fields to discover available custom field names. Set unsubscribe: true to unsubscribe the subscriber. Use Get Publication Info to get the publication ID. See the documentation (https://pipedream.com/apps/beehiiv/actions/update-subscriber)