About Magileads: Magileads is your trusted source for valuable information and resources. L'outil ultime pour une prospection multicanale réussie We provide reliable, well-researched information content to keep you informed and help you make better decisions. This content focuses on API Magileads V2 and related topics.

En bref : l’API Magileads V2 (version 2.0.0, spécification OpenAPI 3.0) est l’API REST de la plateforme Magileads de prospection multicanale B2B. Elle expose 505 endpoints répartis en 47 groupes, accessibles sur https://app.api-magileads.net avec une clé transmise dans l’en-tête x-api-key. Elle permet d’automatiser l’intégralité du cycle de génération de leads : ciblage LinkedIn, Sales Navigator et Google Maps, enrichissement e-mail et téléphone, campagnes e-mail, LinkedIn et SMS, PRM, statistiques et marque blanche.

Cette page est la référence complète de l’API Magileads V2. Elle s’adresse aux développeurs, intégrateurs, Growth Ops et agences qui souhaitent connecter Magileads à leur CRM, à leurs outils no-code ou à leur back-office, et industrialiser la prospection B2B sans passer par l’interface.

L’application : application.magileads.io ou le site internet magileads.com

Fiche technique de l’API Magileads V2

NomMagileads API
Version2.0.0
SpécificationOpenAPI 3.0 (OAS 3.0), fichier swagger.json
TypeAPI REST, réponses JSON
URL de basehttps://app.api-magileads.net
AuthentificationClé d’API (en-tête x-api-key) ou OAuth 2.0
Fuseau horaireToutes les dates sont en GMT
Volume505 endpoints, 47 groupes : 154 GET, 200 POST, 82 PUT, 69 DELETE
Supportco*****@*******ds.eu

Répartition des endpoints par domaine fonctionnel

DomaineGroupesEndpoints
Accès, authentification et sécuritéInformations sur l’API, Clés d’API, OAuth 2.0, Permissions, Rôles, Clés d’API Magileads V2 externes31
Utilisateurs, organisations et abonnementsUtilisateurs, Organisations, Équipes, Abonnements et facturation, Affiliation, Notifications, Retours utilisateurs73
Ciblage et extraction de leads B2BCiblage LinkedIn et Sales Navigator, Ciblage Google Maps, Ciblage base de données35
Données de contacts, enrichissement et conformitéListes de contacts, Champs de données, Enrichissement par lot, Listes noires (blacklists), Désinscrits, Tags60
Messages, modèles et agents IAAgents IA, Modèles d’e-mails, Modèles d’invitations LinkedIn, Modèles de messages LinkedIn, Modèles SMS, Modèles SMV, Signatures e-mail62
Campagnes multicanales (workflows)Workflows et programmations, Jobs, Pools d’intégrations, Raccourcisseur d’URL, Formulaires62
Canaux d’envoi et délivrabilitéIntégrations e-mail, Intégrations LinkedIn, OVH (domaines et e-mails)33
PRM : CRM de prospectionPRM57
Statistiques et reportingStatistiques, Rapports26
Automatisation et intégrations tiercesWebhooks, Zapier, Crons22
Marque blanche (revendeurs)Revendeurs, Revendeurs : Mailgun33
Fichiers et dossiersFichiers, Dossiers11

Authentification à l’API Magileads V2

Deux mécanismes coexistent :

  • Clé d’API : chaque requête porte l’en-tête x-api-key. Les clés se gèrent par API (/api-keys) : génération, régénération et suppression. C’est la méthode adaptée aux scripts serveur et aux intégrations internes.
  • OAuth 2.0 : pour les applications tierces agissant au nom d’un utilisateur. Le serveur d’autorisation se découvre via GET /.well-known/oauth-authorization-server et supporte le flux authorization code, l’enregistrement dynamique de client, le rafraîchissement et la révocation de jetons.

Bonne pratique de sécurité : la clé d’API donne accès à toutes les données du compte. Ne l’exposez jamais côté navigateur, dans une URL partagée ou dans un dépôt de code. En cas de fuite, régénérez-la immédiatement avec PUT /api-keys/{api_key_id}/regenerate.

Démarrage rapide : premier appel

Le premier appel recommandé est GET /users/me, qui renvoie le profil du compte associé à la clé et valide la configuration.

Avec cURL

curl -X GET "https://app.api-magileads.net/users/me" \
  -H "accept: application/json" \
  -H "x-api-key: VOTRE_CLE_API"

En PHP (WordPress)

<?php
declare(strict_types=1);
/**
 * Récupère le profil du compte Magileads associé à la clé d’API.
 * La clé est lue depuis une constante définie dans wp-config.php, jamais en base ni en dur.
 *
 * @return array<string, mixed>|WP_Error
 */
function magileads_get_my_profile(): array|WP_Error {
    if ( ! defined( 'MAGILEADS_API_KEY' ) ) {
        return new WP_Error( 'magileads_no_key', 'Constante MAGILEADS_API_KEY absente.' );
    }
    $response = wp_remote_get(
        'https://app.api-magileads.net/users/me',
        array(
            'timeout' => 15,
            'headers' => array(
                'Accept'    => 'application/json',
                'x-api-key' => (string) MAGILEADS_API_KEY,
            ),
        )
    );
    if ( is_wp_error( $response ) ) {
        return $response;
    }
    $code = (int) wp_remote_retrieve_response_code( $response );
    if ( 200 !== $code ) {
        return new WP_Error( 'magileads_http_' . $code, 'Réponse HTTP inattendue.' );
    }
    $data = json_decode( wp_remote_retrieve_body( $response ), true );
    return is_array( $data ) ? $data : new WP_Error( 'magileads_json', 'JSON invalide.' );
}

En JavaScript (Node.js, côté serveur uniquement)

// Appel côté serveur : la clé reste dans une variable d’environnement.
const res = await fetch("https://app.api-magileads.net/users/me", {
  headers: { accept: "application/json", "x-api-key": process.env.MAGILEADS_API_KEY }
});
if (!res.ok) throw new Error(`Magileads API : HTTP ${res.status}`);
const profile = await res.json();

Cas d’usage de l’API Magileads V2

1. Constituer une audience B2B qualifiée

Les endpoints Targeting – LinkedIn, Targeting – Google et Targeting – Database alimentent des listes de contacts à partir de recherches Sales Navigator, d’engagements sur des posts LinkedIn, de visiteurs de profil ou de fiches Google Maps.

2. Enrichir et nettoyer les données

Les lots Enrich et les endpoints d’enrichissement e-mail et mobile complètent les fiches. Les blacklists et les désinscrits s’appliquent directement aux listes pour respecter le RGPD avant tout envoi.

3. Lancer des séquences multicanales personnalisées par IA

Les modèles e-mail, invitations et messages LinkedIn se génèrent par IA puis s’assemblent dans un workflow, programmé sur des comptes d’envoi regroupés en pools avec warmup SMTP.

4. Traiter les réponses dans le PRM

Le PRM centralise les répondants : qualification positive ou négative, suggestion de réponse par IA, notes, appels, statuts personnalisés et nurturing.

5. Mesurer et synchroniser

Les statistiques analysent les répondants par secteur, taille d’entreprise, pays ou canal. Les webhooks et Zapier poussent les événements vers le CRM.

Référence complète des 505 endpoints de l’API Magileads V2

Les endpoints sont regroupés par domaine fonctionnel. Les segments entre accolades (par exemple {contact_list_id}) sont des paramètres de chemin. {file_type} désigne le format d’export demandé. Les descriptions reprennent les libellés officiels de la spécification OpenAPI.

Accès, authentification et sécurité

Points d’entrée qui contrôlent l’accès à l’API : clés d’API, serveur d’autorisation OAuth 2.0, rôles, permissions et clés d’API de services tiers. 31 endpoints.

Informations sur l’API API

Retourne les métadonnées de l’API, globalement ou pour un domaine SaaS donné (instance en marque blanche). 2 endpoints.

MéthodeEndpointDescription
GET/apiApi information
GET/api/{saas_domain}Api information

Clés d’API API Keys

Cycle de vie complet des clés d’API (token) : génération, mise à jour, régénération et révocation. La régénération invalide l’ancienne clé. 6 endpoints.

MéthodeEndpointDescription
GET/api-keysFetch list
GET/api-keys/{api_key_id}Find profile
POST/api-keysGenerate an API Key (token)
PUT/api-keys/{api_key_id}Update profile
PUT/api-keys/{api_key_id}/regenerateRegenerate an API Key (token)
DELETE/api-keys/{api_key_id}Delete an API Key

OAuth 2.0 OAuth

Serveur d’autorisation conforme OAuth 2.0 : découverte via /.well-known/oauth-authorization-server, flux authorization code, enregistrement dynamique de client, échange et rafraîchissement de jetons, révocation et clés de signature JWKS. 8 endpoints.

MéthodeEndpointDescription
GET/.well-known/oauth-authorization-serverDiscover the OAuth authorization server
GET/oauth/authorization-transactions/{transaction_id}Fetch an OAuth consent transaction
GET/oauth/authorizeStart an authorization-code flow
GET/oauth/jwks.jsonFetch OAuth signing keys
POST/oauth/authorization-transactions/{transaction_id}Approve or deny an OAuth consent transaction
POST/oauth/registerRegister an OAuth client dynamically
POST/oauth/revokeRevoke an OAuth token
POST/oauth/tokenExchange or refresh OAuth tokens

Permissions Permissions

Lecture et modification unitaire ou par lot des permissions accordées à chaque utilisateur. 5 endpoints.

MéthodeEndpointDescription
GET/permissionsFetch list
GET/permissions/{user_id}Fetch list of a user
PUT/permissions/{permission_name}/{user_id}Update a user permission
PUT/permissions/{user_id}Batch update user permissions
DELETE/permissions/{permission_name}/{user_id}Delete a permission

Rôles Roles

Création et gestion des rôles qui regroupent les droits des utilisateurs. 5 endpoints.

MéthodeEndpointDescription
GET/rolesFetch list
GET/roles/{role_id}Find profile
POST/rolesCreate a role
PUT/roles/{role_id}Update profile
DELETE/roles/{role_id}Delete a role

Clés d’API externes External API keys

Stockage des clés de services tiers (fournisseurs d’enrichissement, OVH…) utilisées ensuite par d’autres endpoints via {external_api_key_id}. 5 endpoints.

MéthodeEndpointDescription
GET/external-api-keysFetch list
GET/external-api-keys/{external_api_key_id}Find profile
POST/external-api-keysAdd profile
PUT/external-api-keys/{external_api_key_id}Update profile
DELETE/external-api-keys/{external_api_key_id}Delete profile

Utilisateurs, organisations et abonnements

Gestion des comptes utilisateurs, des organisations, des équipes, de la facturation et des notifications. 73 endpoints.

Utilisateurs Users

Inscription, authentification (avec rafraîchissement), connexion via fournisseurs tiers, profil courant (/users/me), avatar, mot de passe, vérification SMS, bascule entre comptes et génération d’un jeton de recherche embarquée. 26 endpoints.

MéthodeEndpointDescription
GET/users/{user_id}Find profile by ID
GET/users/listRetrieve the list of users
GET/users/meFind my profile
GET/users/me/quickFind my profile (quick version)
POST/oauth/{provider}/redirectRegister or login using third party logins
POST/users/{user_id}/avatarUpload an avatar to a user account
POST/users/authenticationAuthentication
POST/users/authentication/refreshRefresh authentication
POST/users/list/searchSearch users
POST/users/me/avatarUpload an avatar to my user account
POST/users/me/embed/search-list/tokenGenerate an embedded search token
POST/users/registerRegister
POST/users/switch/to/{user_id}Switch to a user account
POST/users/verification/sms/resendResend SMS verification code
PUT/users/{user_id}Update profile by ID
PUT/users/{user_id}/disableDisable by ID
PUT/users/meUpdate my profile
PUT/users/me/disableDisable
PUT/users/password/forgotForgot password
PUT/users/password/resetReset password
PUT/users/unlockUnlock user account
PUT/users/verification/sms/confirmConfirm account via SMS code
DELETE/users/{user_id}Delete an user account
DELETE/users/{user_id}/avatarDelete the avatar of a user account
DELETE/users/meDelete my user account
DELETE/users/me/avatarDelete the avatar from my user account

Organisations Organizations

Création d’organisations, invitation et adhésion d’utilisateurs, gestion des niveaux et des rôles des membres. 11 endpoints.

MéthodeEndpointDescription
GET/organizationsFetch list
GET/organizations/{organization_id}Find profile
GET/organizations/{organization_id}/usersFetch users list
POST/organizationsCreate an organization
POST/organizations/{organization_id}/inviteInvite an user to an organization
POST/organizations/joinJoin an organization
PUT/organizations/{organization_id}Update profile
PUT/organizations/{organization_id}/level/{user_id}Update the level of a user
PUT/organizations/{organization_id}/role/{user_id}Update the role of an user
DELETE/organizations/{organization_id}Delete an organization
DELETE/organizations/{organization_id}/leaveLeave an organization

Équipes Teams

Équipes au sein d’un compte : invitations, adhésion, niveaux et rôles des membres. 10 endpoints.

MéthodeEndpointDescription
GET/teams/{team_id}Find profile
GET/teams/{team_id}/usersFetch users list
POST/teamsCreate a team
POST/teams/{team_id}/inviteInvite an user to a team
POST/teams/joinJoin a team
PUT/teams/{team_id}Update profile
PUT/teams/{team_id}/level/{user_id}Update the level of a user
PUT/teams/{team_id}/role/{user_id}Update the role of an user
DELETE/teams/{team_id}Delete a team
DELETE/teams/{team_id}/leaveLeave a team

Abonnements et facturation Subscriptions

Produits, souscription et résiliation, options d’abonnement, moyens de paiement, informations client et téléchargement des factures. 12 endpoints.

MéthodeEndpointDescription
GET/subscriptions/invoicesFetch client invoices list
GET/subscriptions/invoices/download/{invoice_id}Download client invoice
GET/subscriptions/productsFetch products list
POST/subscriptions/add/payment-methodAdd and set default payment method
POST/subscriptions/subscribeSubscribe
POST/subscriptions/subscribe/{user_id}Subscribe
POST/subscriptions/update/customer-infoUpdate customer information
POST/subscriptions/update/default-payment-methodUpdate the default payment method
PUT/subscriptions/add/optionsAdd Subscription Options
DELETE/subscriptions/remove/optionsRemove Subscription Options
DELETE/subscriptions/unsubscribeUnsubscribe
DELETE/subscriptions/unsubscribe/{user_id}Unsubscribe

Affiliation Affiliation

Liste des utilisateurs rattachés au programme d’affiliation. 1 endpoint.

MéthodeEndpointDescription
GET/affiliation/usersFetch users list

Notifications Notifications

Notifications et alertes de compte : lecture, marquage lu/non lu, masquage et paramètres de notification. 12 endpoints.

MéthodeEndpointDescription
GET/notificationsFetch notifications
GET/notifications/alertsFetch account alerts
GET/notifications/settingsFetch notification settings
PUT/notifications/alerts/hideHide an account alert
PUT/notifications/alerts/unhideUnhide an account alert
PUT/notifications/hideHide notifications
PUT/notifications/hide-allHide all notifications
PUT/notifications/readMark notifications as read
PUT/notifications/read-allMark all notifications as read
PUT/notifications/settingsUpdate notification settings
PUT/notifications/unhideUnhide notifications
PUT/notifications/unreadMark notifications as unread

Retours utilisateurs Feedbacks

Envoi d’un retour (feedback) à l’équipe Magileads. 1 endpoint.

MéthodeEndpointDescription
POST/feedbacksSend a feedback

Ciblage et extraction de leads B2B

Génération de leads : extraction de contacts et d’entreprises depuis LinkedIn, Sales Navigator, Google Maps et la base de données Magileads. 35 endpoints.

Ciblage LinkedIn et Sales Navigator Targeting – LinkedIn

Extraction de profils et d’entreprises depuis les recherches LinkedIn et Sales Navigator (modes asynchrone, synchrone et alternatif), des connexions, des membres de groupes, des participants à un événement, des visiteurs de profil ou de page entreprise, des interactions sur les posts (likes, commentaires, partages), de l’activité des profils et des publicateurs d’offres d’emploi. Inclut la génération d’URL de recherche et la recherche d’identifiants de localisation. 27 endpoints.

MéthodeEndpointDescription
POST/targeting/linkedin/{contact_list_id}/relaunch-errorsRelaunch LinkedIn extractions with errors
POST/targeting/linkedin/extract-companies-search-syncExtract LinkedIn companies from a company search (synchronous)
POST/targeting/linkedin/extract-company-viewersExtract LinkedIn company viewers
POST/targeting/linkedin/extract-connectionsExtract contacts from LinkedIn connections
POST/targeting/linkedin/extract-event-attendeesExtract LinkedIn event attendees
POST/targeting/linkedin/extract-group-membersExtract LinkedIn group members
POST/targeting/linkedin/extract-people-comment-activityExtract LinkedIn people comment activity
POST/targeting/linkedin/extract-people-post-activityExtract LinkedIn people post activity
POST/targeting/linkedin/extract-people-reaction-activityExtract LinkedIn people reaction activity
POST/targeting/linkedin/extract-peoples-searchExtract contacts from a LinkedIn search
POST/targeting/linkedin/extract-peoples-search-alternativeExtract contacts from a LinkedIn search (alternative)
POST/targeting/linkedin/extract-peoples-search-syncExtract LinkedIn profiles from a people search (synchronous)
POST/targeting/linkedin/extract-post-commentersExtract contacts who commented on a LinkedIn post
POST/targeting/linkedin/extract-post-likersExtract contacts who liked a post on LinkedIn
POST/targeting/linkedin/extract-post-repostersExtract LinkedIn post reposters
POST/targeting/linkedin/extract-postsExtract posts on LinkedIn
POST/targeting/linkedin/extract-posts-syncExtract LinkedIn posts (synchronous)
POST/targeting/linkedin/extract-profile-viewersExtract LinkedIn profile viewers
POST/targeting/linkedin/extract-publishers-job-offersExtract the publishers of job offers on LinkedIn
POST/targeting/linkedin/extract-sales-navigator-companies-searchExtract companies from a Sales Navigator search
POST/targeting/linkedin/extract-sales-navigator-companies-search-alternativeExtract companies from a Sales Navigator search (alternative)
POST/targeting/linkedin/extract-sales-navigator-peoples-searchExtract contacts from a Sales Navigator search
POST/targeting/linkedin/extract-sales-navigator-peoples-search-alternativeExtract contacts from a Sales Navigator search (alternative)
POST/targeting/linkedin/generate-peoples-search-urlGenerate a Linkedin peoples search url
POST/targeting/linkedin/generate-sales-navigator-peoples-search-urlGenerate a Linkedin Sales Navigator peoples search url
POST/targeting/linkedin/locations/searchSearch linkedin location ids
POST/targeting/linkedin/refresh/{contact_list_id}Refresh LinkedIn targeting on a contact list

Ciblage Google Maps Targeting – Google

Extraction d’entreprises et de contacts depuis des recherches Google Maps, génération d’URL de recherche et relance des extractions (y compris celles en erreur). 4 endpoints.

MéthodeEndpointDescription
POST/targeting/google/extract-maps-searchExtract contacts from a Google Maps Search
POST/targeting/google/extract-maps-search/{contact_list_id}/relaunchRelaunch extractions
POST/targeting/google/extract-maps-search/{contact_list_id}/relaunch-errorsRelaunch extractions with errors
POST/targeting/google/generate-maps-search-urlsGenerate Google Maps Search URLs

Ciblage base de données Targeting – Database

Comptage, prévisualisation et extraction de contacts depuis la base de données Magileads à partir de filtres, avec recherche de localisations. 4 endpoints.

MéthodeEndpointDescription
POST/targeting/database/countCount the number of contacts found with the given filters
POST/targeting/database/count-previewCount and preview contacts based on filters
POST/targeting/database/extractExtract contacts found with the given filters
POST/targeting/database/locations/searchSearch database location

Données de contacts, enrichissement et conformité

Stockage, structuration et enrichissement des contacts, plus les listes d’exclusion indispensables à la conformité RGPD. 60 endpoints.

Listes de contacts Contact Lists

Listes de contacts et contacts unitaires : pagination, recherche transverse, fusion, export par type de fichier, valeurs uniques et mise à jour en masse d’un champ. Nettoyage avancé : suppression des contacts présents dans une blacklist, dans une autre liste ou parmi les désinscrits, et limitation du nombre de contacts par entreprise. Enrichissement d’e-mail et de mobile. 26 endpoints.

MéthodeEndpointDescription
GET/contact-listsFetch all lists
GET/contact-lists-paginatedFetch paginated list
GET/contact-lists/{contact_list_id}Find profile
GET/contact-lists/{contact_list_id}/contactsFetch contacts
GET/contact-lists/{contact_list_id}/contacts/{contact_id}Find contact profile
GET/contact-lists/{contact_list_id}/datafields/{datafield_id}/valuesGet unique values from a datafield
GET/contact-lists/{contact_list_id}/download/{file_type}Download the list of contacts
GET/contact-lists/namesFetch contact list IDs and names
POST/contact-lists/contacts/searchSearch contacts in all contact list
POST/contact-lists/download/{file_type}Download the list of contacts from all contacts lists
POST/contact-lists/mergeMerge contact lists
POST/contacts/enrich/emailEnrich a contact email from company and optional names
POST/contacts/enrich/phone/mobileEnrich a contact mobile phone from LinkedIn URL
PUT/contact-lists/{contact_list_id}Update profile
PUT/contact-lists/{contact_list_id}/contacts/{contact_id}Update contact
PUT/contact-lists/{contact_list_id}/datafields/{datafield_id}/bulk-setBulk set datafield value
DELETE/contact-lists/{contact_list_id}Delete a contact list
DELETE/contact-lists/{contact_list_id}/contactsDelete contacts from a contact list
DELETE/contact-lists/{contact_list_id}/contacts/{contact_id}Delete Contact
DELETE/contact-lists/{contact_list_id}/contacts/blacklist/{blacklist_id}Delete contacts from a contact list found in a blacklist
DELETE/contact-lists/{contact_list_id}/contacts/contact-list/{source_contact_list_id}Delete contacts from a contact list found in another contact list
DELETE/contact-lists/{contact_list_id}/contacts/unsubscribersDelete contacts from a contact list found in unsubscribers
DELETE/contact-lists/{contact_list_id}/contacts/unsubscribers/{organization_id}Delete contacts from a contact list found in unsubscribers from an organization
DELETE/contact-lists/{contact_list_id}/delete/company/{keep_contacts}Delete contacts on a contact list to keep only a certain amount of contacts by company
DELETE/contact-lists/contactsDelete Contacts
DELETE/contact-lists/contacts/selectionDelete Contacts from a selection

Champs de données Data Fields

Champs personnalisés (data fields) attachés aux contacts. 5 endpoints.

MéthodeEndpointDescription
GET/data-fieldsFetch list
GET/data-fields/{data_field_id}Find profile
POST/data-fieldsCreate a data field
PUT/data-fields/{data_field_id}Update profile
DELETE/data-fields/{data_field_id}Delete a data field

Enrichissement par lot Enrich

Création de lots d’enrichissement, récupération des résultats et statistiques de consommation. 3 endpoints.

MéthodeEndpointDescription
GET/enrich/{batch_id}Get enrich batch results
POST/enrichCreate an enrich batch
POST/enrich/usageGet enrich usage statistics

Listes noires (blacklists) Blacklists

Listes d’exclusion : création, import de données, recherche ciblée ou globale, téléchargement (avec ou sans filtre) et suppression de données. 13 endpoints.

MéthodeEndpointDescription
GET/blacklistsFetch list
GET/blacklists/{blacklist_id}Find profile
GET/blacklists/{blacklist_id}/dataFetch data
GET/blacklists/{blacklist_id}/download/{file_type}Download the blacklist
POST/blacklistsCreate a blacklist
POST/blacklists/{blacklist_id}/dataImport data
POST/blacklists/{blacklist_id}/data/searchSearch data in specific blacklist
POST/blacklists/{blacklist_id}/download/{file_type}Download the blacklist using a filter
POST/blacklists/data/searchSearch data in all blacklist
PUT/blacklists/{blacklist_id}Update profile
DELETE/blacklists/{blacklist_id}Delete a blacklist
DELETE/blacklists/{blacklist_id}/data/{data_id}Delete Data
DELETE/blacklists/datasDelete Datas

Désinscrits Unsubscribers

Gestion des désinscriptions globale ou par organisation : import, recherche, téléchargement et suppression. 8 endpoints.

MéthodeEndpointDescription
GET/unsubscribersFetch unsubscribers
GET/unsubscribers/download/{file_type}Download the list of unsubscribers
GET/unsubscribers/organization/{organization_id}Retrieve unsubscribers from an organization
GET/unsubscribers/organization/{organization_id}/download/{file_type}Download the list of unsubscribers from an organization
POST/unsubscribersImport unsubscribers
POST/unsubscribers/organization/{organization_id}/searchSearch unsubscribers from specific organization
POST/unsubscribers/searchSearch unsubscribers from all organizations
DELETE/unsubscribers/{unsubscriber_id}Delete an unsubscriber

Tags Tags

Étiquettes réutilisables pour segmenter les contacts. 5 endpoints.

MéthodeEndpointDescription
GET/tagsFetch list
GET/tags/{tag_id}Find profile
POST/tagsCreate a tag
PUT/tags/{tag_id}Update profile
DELETE/tags/{tag_id}Delete a tag

Messages, modèles et agents IA

Modèles de messages pour chaque canal et agents IA chargés de rédiger et personnaliser le contenu des campagnes. 62 endpoints.

Agents IA AiAgents

Création et gestion d’agents IA, génération d’un brief à partir d’un agent existant ou sans agent. 7 endpoints.

MéthodeEndpointDescription
GET/ai-agentsFetch AI agents
GET/ai-agents/{uniqid}Find AI agent by uniqid
POST/ai-agentsCreate AI agent
POST/ai-agents/{uniqid}/generate-briefGenerate AI agent brief
POST/ai-agents/generate-briefGenerate AI agent brief without an existing agent
PUT/ai-agents/{uniqid}Update AI agent
DELETE/ai-agents/{uniqid}Delete AI agent

Modèles d’e-mails Models – Email

Modèles d’e-mails : génération et régénération par IA (texte et HTML), personnalisation par contact, import du HTML d’une URL, copie entre comptes et envoi de tests. 15 endpoints.

MéthodeEndpointDescription
GET/models/emailFetch list
GET/models/email/{model_id}Find profile
GET/models/email/{model_id}/{contact_id}Find AI model profile and generate content
GET/models/email/{model_id}/{contact_id}/regenerateFind AI model profile and regenerate content
POST/models/emailCreate an email model
POST/models/email/{model_id}/copyCopy an email model
POST/models/email/{model_id}/copy/to/{user_id}Copy an email model to user ID
POST/models/email/{model_id}/regenerateRegenerate an email model using AI
POST/models/email/{model_id}/send/testSend an email campaign on your test emails
POST/models/email/generateGenerate an email model using AI
POST/models/email/generate/htmlGenerate HTML email using AI
POST/models/email/get/html/from/urlGet HTML from URL
POST/models/email/send/testSend an email campaign on your test emails without creating a model
PUT/models/email/{model_id}Update an email model
DELETE/models/email/{model_id}Delete an email model

Modèles d’invitations LinkedIn Models – LinkedIn Invitation

Modèles de demandes de connexion LinkedIn, avec génération de contenu par IA et personnalisation par contact. 10 endpoints.

MéthodeEndpointDescription
GET/models/linkedin/invitationFetch list
GET/models/linkedin/invitation/{model_id}Find profile
GET/models/linkedin/invitation/{model_id}/{contact_id}Find AI model profile and generate content
GET/models/linkedin/invitation/{model_id}/{contact_id}/regenerateFind AI model profile and regenerate content
POST/models/linkedin/invitationCreate a LinkedIn invitation
POST/models/linkedin/invitation/{model_id}/copyCopy a LinkedIn invitation
POST/models/linkedin/invitation/{model_id}/copy/to/{user_id}Copy a LinkedIn invitation to user ID
POST/models/linkedin/invitation/generate/contentGenerate LinkedIn invitation content using AI
PUT/models/linkedin/invitation/{model_id}Update a LinkedIn invitation
DELETE/models/linkedin/invitation/{model_id}Delete a LinkedIn invitation

Modèles de messages LinkedIn Models – LinkedIn Message

Modèles de messages LinkedIn, avec génération de contenu par IA et personnalisation par contact. 10 endpoints.

MéthodeEndpointDescription
GET/models/linkedin/messageFetch list
GET/models/linkedin/message/{model_id}Find profile
GET/models/linkedin/message/{model_id}/{contact_id}Find AI model profile and generate content
GET/models/linkedin/message/{model_id}/{contact_id}/regenerateFind AI model profile and regenerate content
POST/models/linkedin/messageCreate a LinkedIn message
POST/models/linkedin/message/{model_id}/copyCopy a LinkedIn message
POST/models/linkedin/message/{model_id}/copy/to/{user_id}Copy a LinkedIn message to user ID
POST/models/linkedin/message/generate/contentGenerate LinkedIn message content using AI
PUT/models/linkedin/message/{model_id}Update a LinkedIn message
DELETE/models/linkedin/message/{model_id}Delete a LinkedIn message

Modèles SMS Models – SMS

Modèles de SMS : création, copie (y compris vers un autre utilisateur), mise à jour et suppression. 7 endpoints.

MéthodeEndpointDescription
GET/models/smsFetch list
GET/models/sms/{model_id}Find profile
POST/models/smsCreate a SMS model
POST/models/sms/{model_id}/copyCopy a SMS model
POST/models/sms/{model_id}/copy/to/{user_id}Copy a SMS model to user ID
PUT/models/sms/{model_id}Update a SMS model
DELETE/models/sms/{model_id}Delete a SMS model

Modèles SMV Models – SMV

Modèles SMV : création, mise à jour, copie (y compris vers un autre utilisateur) et suppression. 7 endpoints.

MéthodeEndpointDescription
GET/models/smvFetch list
GET/models/smv/{model_id}Find profile
POST/models/smvCreate a SMV model
POST/models/smv/{model_id}Update a SMV model
POST/models/smv/{model_id}/copyCopy a SMV model
POST/models/smv/{model_id}/copy/to/{user_id}Copy a SMV model to user ID
DELETE/models/smv/{model_id}Delete a SMV model

Signatures e-mail Email Signatures

Signatures d’e-mail réutilisables dans les campagnes. 6 endpoints.

MéthodeEndpointDescription
GET/email-signaturesFetch list
GET/email-signatures/{email_signature_id}Find profile
POST/email-signaturesCreate an email signature
POST/email-signatures/{email_signature_id}/copyCopy an email signature
PUT/email-signatures/{email_signature_id}Update profile
DELETE/email-signatures/{email_signature_id}Delete an email signature

Campagnes multicanales (workflows)

Orchestration des séquences de prospection multicanales et de leur exécution. 62 endpoints.

Workflows et programmations Workflows

Cœur de l’automatisation : création, copie et programmation de workflows, pilotage des programmations (arrêt, reprise, archivage, par étape), contacts par étape et par type (export, copie vers une liste, ajout en blacklist), cliqueurs par lien, exclusions, envoi d’e-mails unitaires, téléchargement des EML et génération de workflows par agent IA (jobs, prévisualisation, évaluation de readiness, régénération). 39 endpoints.

MéthodeEndpointDescription
GET/workflowsFetch list
GET/workflows/{workflow_id}Find profile
GET/workflows/{workflow_id}/programmation/{workflow_programmation_id}Find a workflow programmation
GET/workflows/{workflow_id}/programmation/{workflow_programmation_id}/{contact_type}Get contacts by workflow programmation and type
GET/workflows/{workflow_id}/programmation/{workflow_programmation_id}/step/{step_id}/{contact_type}Get contacts by workflow programmation step and type
GET/workflows/{workflow_id}/programmation/{workflow_programmation_id}/step/{step_id}/click/link/{link_url}Get clicker contacts by workflow programmation step and type and link
GET/workflows/{workflow_id}/programmationsFetch workflow programmations by workflow id
GET/workflows/ai-agent/jobsFetch AI agent workflow generation jobs
GET/workflows/ai-agent/jobs/{job_uniqid}Fetch AI agent workflow generation status
GET/workflows/exclude/programmation/{programmation_id}List exclusions of contacts from a programmation
GET/workflows/programmationsFetch workflow programmations
GET/workflows/programmations/contactsFetch workflow programmations contacts
GET/workflows/reply/email/{reply_id}/download/emlDownload the eml of an email reply
GET/workflows/sent/email/{id}/download/emlDownload the eml of an email manually sent
POST/workflowsCreate a workflow
POST/workflows/{workflow_id}/copyCopy a workflow
POST/workflows/{workflow_id}/copy/to/{user_id}Copy a workflow to user ID
POST/workflows/{workflow_id}/imageUpload workflow image
POST/workflows/{workflow_id}/programProgram a workflow
POST/workflows/{workflow_id}/programmation/{workflow_programmation_id}/{contact_type}/{file_type}Download contacts by workflow programmation and type
POST/workflows/{workflow_id}/programmation/{workflow_programmation_id}/step/{step_id}/{contact_type}/{file_type}Download contacts by workflow programmation step and type
POST/workflows/{workflow_id}/programmation/{workflow_programmation_id}/step/{step_id}/{contact_type}/blacklist/{blacklist_id}Blacklist contacts by workflow programmation step and type
POST/workflows/{workflow_id}/programmation/{workflow_programmation_id}/step/{step_id}/{contact_type}/copy-to/{contact_list_id_destination}Copy contacts of a workflow programmation step and type to a contact list
POST/workflows/{workflow_id}/readinessEvaluate AI agent workflow readiness
POST/workflows/ai-agentQueue AI agent workflow draft generation
POST/workflows/ai-agent/jobs/{job_uniqid}/contact-previewGenerate grouped AI agent contact previews
POST/workflows/ai-agent/regenerateRegenerate an AI campaign message or workflow
POST/workflows/send/emailSend a single email
POST/workflows/send/email-with-attachmentsSend a single email with attachments
PUT/workflows/{workflow_id}Update profile
PUT/workflows/{workflow_id}/programmation/{workflow_programmation_id}Update programmation profile
PUT/workflows/{workflow_id}/programmation/{workflow_programmation_id}/archiveArchive a workflow programmation
PUT/workflows/{workflow_id}/programmation/{workflow_programmation_id}/resumeResume a workflow programmation
PUT/workflows/{workflow_id}/programmation/{workflow_programmation_id}/step/{step_id}/resumeResume a workflow programmation step
PUT/workflows/{workflow_id}/programmation/{workflow_programmation_id}/step/{step_id}/stopStop a workflow programmation step
PUT/workflows/{workflow_id}/programmation/{workflow_programmation_id}/stopStop a workflow programmation
PUT/workflows/{workflow_id}/programmation/{workflow_programmation_id}/unarchiveUnarchive a workflow programmation
DELETE/workflows/{workflow_id}Delete a workflow
DELETE/workflows/exclude/programmation/{exclusion_id}Remove exclusion of a contact from a programmation

Jobs Jobs

Suivi et arrêt des tâches asynchrones, suppression des résultats en échec. 3 endpoints.

MéthodeEndpointDescription
GET/jobs/prm/{target_id}List prm jobs
DELETE/jobs/{job_uniqid}Stop a job
DELETE/jobs/failed/{job_uniqid}Delete failed job result

Pools d’intégrations Pools

Regroupement de comptes d’envoi (intégrations) en pools. 7 endpoints.

MéthodeEndpointDescription
GET/poolsFetch list
GET/pools/{pool_id}Find profile
POST/poolsCreate a pool
POST/pools/{pool_id}/{integration_id}Add an integration in the pool
PUT/pools/{pool_id}Update profile
DELETE/pools/{pool_id}Delete a pool
DELETE/pools/{pool_id}/{integration_id}Remove an integration in the pool

Raccourcisseur d’URL URLs Shortener

Création unitaire ou en masse d’URL courtes utilisées dans les messages. 7 endpoints.

MéthodeEndpointDescription
GET/urls-shortenerFetch list
GET/urls-shortener/{shortened_url_id}Find profile
GET/urls-shortener/{url_code}Find URL by URL code
POST/urls-shortenerCreate a shortened URL
POST/urls-shortener/bulkCreate shortened URLs in bulk
PUT/urls-shortener/{shortened_url_id}Update profile
DELETE/urls-shortener/{shortened_url_id}Delete a shortened URL

Formulaires Forms

Création, copie et gestion de formulaires. 6 endpoints.

MéthodeEndpointDescription
GET/formsFetch list
GET/forms/{form_id}Find profile
POST/formsCreate a form
POST/forms/{form_id}/copyCopy a form
PUT/forms/{form_id}Update a form profile
DELETE/forms/{form_id}Delete a form

Canaux d’envoi et délivrabilité

Connexion des comptes d’envoi et outils de délivrabilité (warmup, protections anti-spam, domaines). 33 endpoints.

Intégrations e-mail Integrations – Email

Comptes Gmail, Outlook, SMTP et mass mailing : découverte automatique des paramètres serveur, test de validité SMTP, réglages et statistiques de warmup, protections anti-spam reçues. 19 endpoints.

MéthodeEndpointDescription
GET/integrations/emailFetch list
GET/integrations/email/{email_account_id}Find profile
GET/integrations/email/discover/{email}Discover email server settings using Autodiscover
GET/integrations/email/protectionsList the anti spam protections you have received by email
GET/integrations/email/smtp/{email_account_id}/warmupRetrieve warmup settings for an SMTP email account
GET/integrations/email/smtp/{email_account_id}/warmup/statsRetrieve warmup statistics for an SMTP email account.
POST/integrations/email/gmailAdd a Gmail email account
POST/integrations/email/mass-mailingAdd an email account for mass mailing
POST/integrations/email/outlookAdd a Outlook email account
POST/integrations/email/smtpAdd a SMTP email account
PUT/integrations/email/gmail/{email_account_id}Update a Gmail email account
PUT/integrations/email/mass-mailing/{email_account_id}Update an email account for mass mailing
PUT/integrations/email/mass-mailing/{email_account_id}/force/validateForce Mass Mailing email validation
PUT/integrations/email/outlook/{email_account_id}Update a Outlook email account
PUT/integrations/email/protection/{protection_id}Set a protection as handled
PUT/integrations/email/smtp/{email_account_id}Update a SMTP email account
PUT/integrations/email/smtp/{email_account_id}/warmupUpdate warmup settings for an SMTP email account
PUT/integrations/email/smtp/validity/testSMTP email accounts validity test
DELETE/integrations/email/{email_account_id}Delete an email account

Intégrations LinkedIn Integrations – LinkedIn

Connexion de comptes LinkedIn, résolution des checkpoints d’authentification, mise à jour et suppression. 6 endpoints.

MéthodeEndpointDescription
GET/integrations/linkedinFetch list
GET/integrations/linkedin/{linkedin_account_id}Find profile
POST/integrations/linkedinAdd a LinkedIn account
POST/integrations/linkedin/{linkedin_account_id}/checkpointSolve an authentication checkpoint using a code that you received. If the checkpoint is via the app, you can enter any code you want once validated
PUT/integrations/linkedin/{linkedin_account_id}Update a LinkedIn account
DELETE/integrations/linkedin/{linkedin_account_id}Delete a LinkedIn account

OVH (domaines et e-mails) OVH

Vérification de disponibilité et de prix d’un domaine, commande de domaines et de comptes Email Pro, synchronisation des actifs OVH. 8 endpoints.

MéthodeEndpointDescription
GET/ovhFetch list
GET/ovh/account/{external_api_key_id}/validate-ordering-prerequisitesCheck OVH account readiness for ordering
GET/ovh/domain/availability/{domain}/{external_api_key_id}Check domain availability and price
GET/ovh/sync-assets/{external_api_key_id}/resultsFetch sync-assets job results
POST/ovh/checkoutOrder a domain and/or associated email pro accounts
POST/ovh/sync-assetsSync OVH domains/emails
DELETE/ovh/domain/{domain_id}Delete an OVH domain
DELETE/ovh/email/{email_id}Delete an OVH email account

PRM : CRM de prospection

Le PRM (Prospect Relationship Management) centralise les contacts engagés et leur historique. 57 endpoints.

PRM PRM

Recherche d’un contact par e-mail ou URL LinkedIn, import et export, notes avec pièces jointes, appels, envoi d’invitations et de messages LinkedIn, statuts personnalisés, tags, partages entre utilisateurs, nurturing, exclusion d’un workflow, enrichissement via API externe, qualification positive/négative des réponses et suggestion de réponse générée par IA. 57 endpoints.

MéthodeEndpointDescription
GET/prm/contactFind a contact profile by email or LinkedIn URL
GET/prm/contact/{contact_id}Find a contact profile
GET/prm/contact/{contact_id}/note/{note_id}/attachmentsGet note attachments
GET/prm/contact/user/{user_id}Find a contact profile of a PRM by email or LinkedIn URL
GET/prm/contactsFetch the contacts of your PRM
GET/prm/contacts/sharedFetch the contacts of your PRM that you shared
GET/prm/contacts/user/{user_id}Fetch contacts of a PRM
GET/prm/contacts/usersFetch contacts of multiple PRM
GET/prm/listList visible PRM
GET/prm/notifications/column-entryRetrieve PRM column-entry notification watchlist
GET/prm/nurturing/{nurturing_id}Get a PRM nurturing
GET/prm/nurturingsGet PRM nurturings
GET/prm/sharingsRetrieve your PRM sharings
GET/prm/statusRetrieve your PRM statuses
GET/prm/status/customRetrieve your PRM custom statuses
POST/prm/contact/{contact_id}/callCreate a PRM call from a contact
POST/prm/contact/{contact_id}/enrich/phone/mobileEnrich a contact phone number
POST/prm/contact/{contact_id}/exclude/{workflow_id}Exclude a PRM contact from a workflow
POST/prm/contact/{contact_id}/exclude/programmation/{programmation_id}Exclude a PRM contact from a programmation
POST/prm/contact/{contact_id}/linkedin/invitationSend a linkedin invitation to a contact
POST/prm/contact/{contact_id}/linkedin/messageSend a linkedin message to a contact
POST/prm/contact/{contact_id}/noteCreate a PRM note from a contact
POST/prm/contact/{contact_id}/note/{note_id}/attachmentUpload note attachments
POST/prm/contact/{contact_id}/programmation/{programmation_id}/step/{step_id}Manually progress a contact to an event after a call step
POST/prm/contact/{contact_id}/reply/{history_type_reply}/{reply_id}/suggest-replyGenerate a suggested reply using AI
POST/prm/contactsImport contact into your PRM
POST/prm/contacts/contact-list/{contact_list_id}/addAdd contacts from a PRM to a contact list
POST/prm/contacts/enrich/external/{enrich_external_api}/{external_api_key_id}Enrich the prm using an external api
POST/prm/contacts/export/{file_type}Export the contacts of your PRM
POST/prm/contacts/importImport contacts
POST/prm/contacts/user/{user_id}Import contact into a PRM
POST/prm/contacts/user/{user_id}/copy/blacklist/{blacklist_id}Copy PRM contacts to a blacklist
POST/prm/contacts/user/{user_id}/enrich/external/{enrich_external_api}/{external_api_key_id}Enrich the prm using an external api
POST/prm/contacts/user/{user_id}/export/{file_type}Export contacts of a PRM
POST/prm/contacts/user/{user_id}/tagsAdd tags to contacts of a PRM
POST/prm/nurturingCreate a PRM nurturing
POST/prm/sharingsCreate sharing
POST/prm/status/customCreate a PRM custom status
PUT/prm/contact/{contact_id}Update a PRM contact
PUT/prm/contact/{contact_id}/note/{note_id}Update a PRM note from a contact
PUT/prm/contact/{contact_id}/reply/{history_type_reply}/{reply_id}Mark a contact reply as positive/negative or remove the mark
PUT/prm/contacts/new_replyUpdate PRM contacts new reply
PUT/prm/contacts/statusUpdate PRM contacts statuses
PUT/prm/notifications/column-entryReplace PRM column-entry notification watchlist
PUT/prm/nurturing/{nurturing_id}Update a PRM nurturing
PUT/prm/sharings/{sharing_id}Update sharing
PUT/prm/status/{status}Update a PRM status
PUT/prm/status/custom/{status_id}Update a PRM custom status
DELETE/prm/contact/{contact_id}/call/{call_id}Delete a PRM call from a contact
DELETE/prm/contact/{contact_id}/note/{note_id}Delete a PRM note from a contact
DELETE/prm/contact/{contact_id}/note/{note_id}/attachment/{attachment_id}Delete note attachment
DELETE/prm/contactsDelete contacts from your PRM
DELETE/prm/contacts/user/{user_id}Delete contacts from a PRM
DELETE/prm/contacts/user/{user_id}/tagsRemove tags from contacts of a PRM
DELETE/prm/nurturing/{nurturing_id}Delete a PRM nurturing
DELETE/prm/sharings/{sharing_id}Delete sharing
DELETE/prm/status/custom/{status_id}Delete a PRM custom status

Statistiques et reporting

Mesure de la performance des campagnes, du global jusqu’au répondant. 26 endpoints.

Statistiques Statistics

Statistiques globales, par intégration et par programmation, détaillées jour par jour, exportables. Analyse des répondants par canal, pays, région, secteur, taille d’entreprise, tag, propriétaire et statut PRM. 21 endpoints.

MéthodeEndpointDescription
GET/statistics/globalFetch global programmations statistics
GET/statistics/integrationsFetch integrations statistics
GET/statistics/messagesRetrieve the list of possible statistics messages
GET/statistics/programmationsFetch programmations statistics
GET/statistics/programmations/{programmation_id}Fetch statistics of a programmation
GET/statistics/programmations/{programmation_id}/download/{file_type}Download the statistics of a programmation
GET/statistics/programmations/download/{file_type}Download programmations statistics
POST/statistics/dateFetch programmation stats by date
POST/statistics/date/contactsDownload programmation contacts by date
POST/statistics/date/detailedFetch programmation stats by various parameters, day by day
POST/statistics/global/detailedFetch global programmation stats by various parameters
POST/statistics/responders/by-channel-and-statusResponders by channel and PRM status
POST/statistics/responders/by-company-sizeResponders by company size
POST/statistics/responders/by-company-size-and-statusResponders by company size and PRM status
POST/statistics/responders/by-countryResponders by country
POST/statistics/responders/by-prm-ownerResponders by PRM contact owner
POST/statistics/responders/by-programmation-and-listResponders by programmation and contact list
POST/statistics/responders/by-regionResponders by country and region
POST/statistics/responders/by-sectorResponders by activity sector (top 10)
POST/statistics/responders/by-sector-and-statusResponders by activity sector (top 10) and PRM status
POST/statistics/responders/by-tagResponders by PRM contact tag

Rapports Reporting

Création et gestion de rapports personnalisés. 5 endpoints.

MéthodeEndpointDescription
GET/reporting/report/{report_id}Retrieve a report
GET/reporting/reportsFetch list of reports
POST/reporting/reportCreate a report
PUT/reporting/report/{report_id}Update report
DELETE/reporting/report/{report_id}Delete a report

Automatisation et intégrations tierces

Connexion de Magileads au reste de la stack (CRM, outils no-code, back-office). 22 endpoints.

Webhooks Webhooks

Création, test et gestion de webhooks pour recevoir les événements Magileads. 6 endpoints.

MéthodeEndpointDescription
GET/webhooksFetch list
GET/webhooks/{webhook_id}Find profile
POST/webhooksCreate a webhook
POST/webhooks/{webhook_id}/testTest a webhook
PUT/webhooks/{webhook_id}Update a webhook
DELETE/webhooks/{webhook_id}Delete a webhook

Zapier Zapier

Hooks Zapier : création, activation, désactivation, test et envoi. 9 endpoints.

MéthodeEndpointDescription
GET/zapierFetch list
GET/zapier/{zapier_hook_id}Find profile
POST/zapierCreate a Zapier hook
POST/zapier/{zapier_hook_id}/sendSend a Zapier hook
POST/zapier/{zapier_hook_id}/testTest a Zapier hook
PUT/zapier/{zapier_hook_id}Update profile
PUT/zapier/{zapier_hook_id}/activateActivate a Zapier hook
PUT/zapier/{zapier_hook_id}/deactivateDeactivate a Zapier hook
DELETE/zapier/{zapier_hook_id}Delete a Zapier hook

Crons Crons

Tâches planifiées : création, exécution manuelle et test avec des données fictives. 7 endpoints.

MéthodeEndpointDescription
GET/cronsFetch list
GET/crons/{cron_id}Find profile
POST/cronsCreate a cron
POST/crons/{cron_id}/executeManually execute a cron
POST/crons/{cron_id}/testTest a cron with dummy data
PUT/crons/{cron_id}Update a cron profile
DELETE/crons/{cron_id}Delete a cron

Marque blanche (revendeurs)

Endpoints destinés aux revendeurs qui opèrent Magileads sous leur propre marque. 33 endpoints.

Revendeurs Resellers

Profil revendeur par ID ou domaine SaaS, utilisateurs et tags, options, messages transactionnels, vidéos tutoriels, CNAME et rafraîchissement DNS, extension Chrome en marque blanche et clé OpenRouter. 22 endpoints.

MéthodeEndpointDescription
GET/resellers/{reseller_domain_saas}Find profile by domain saas
GET/resellers/{reseller_domain_saas}/usersFetch users list by domain saas
GET/resellers/{reseller_id}Find profile by ID
GET/resellers/{reseller_id}/download/extension/chromeDownload extension for Chrome
GET/resellers/{reseller_id}/openrouter-api-keyRetrieve the reseller OpenRouter API key
GET/resellers/{reseller_id}/optionsGet options of a reseller
GET/resellers/{reseller_id}/tutorial/videosGet tutorial videos of a reseller
GET/resellers/{reseller_id}/usersFetch users list by ID
GET/resellers/cnamesFetch list of our CNAMES
GET/resellers/messagesGet transactionnal base messages
GET/resellers/messages/{reseller_id}Get transactionnal messages of a reseller, including base messages
POST/resellersCreate a reseller. Users of your reseller will need to use your domain_saas/domain_saas2/domain_saas3/domain_saas4
POST/resellers/{reseller_id}Update profile
POST/resellers/{reseller_id}/dns-refresh-requestsDNS refresh requests for reseller domains
POST/resellers/{reseller_id}/messagesCreate or update a transactionnal message for a reseller
POST/resellers/{reseller_id}/optionsCreate or update multiple options for a reseller
POST/resellers/{reseller_id}/tutorial/videosCreate, update or delete multiple tutorial videos for a reseller
PUT/resellers/{reseller_id}/messages/table-columns/prm-digestConfigure table columns for PRM daily digest email
PUT/resellers/{reseller_id}/role/{user_id}Update the role of an user
PUT/resellers/{reseller_id}/users/{user_id}/tagsUpdate reseller user tags
DELETE/resellers/{reseller_id}Delete a reseller
DELETE/resellers/{reseller_id}/users/{user_id}Delete reseller user

Revendeurs : Mailgun Resellers – Mailgun

Configuration Mailgun gérée par le revendeur : domaines (création, import, partage, vérification DNS) et statistiques du mois en cours. 11 endpoints.

MéthodeEndpointDescription
GET/resellers/{reseller_id}/mailgunRetrieve the reseller Mailgun configuration
GET/resellers/{reseller_id}/mailgun/domainsList visible reseller-managed Mailgun domains
GET/resellers/{reseller_id}/mailgun/domains/{domain_id}Retrieve a reseller-managed Mailgun domain
GET/resellers/{reseller_id}/mailgun/statisticsRetrieve current-month managed Mailgun statistics
POST/resellers/{reseller_id}/mailgunConfigure reseller-managed Mailgun
POST/resellers/{reseller_id}/mailgun/domain-importsImport an existing Mailgun domain
POST/resellers/{reseller_id}/mailgun/domainsCreate a reseller-managed Mailgun domain
POST/resellers/{reseller_id}/mailgun/domains/{domain_id}Update managed Mailgun domain ownership and sharing
POST/resellers/{reseller_id}/mailgun/domains/{domain_id}/dns-refresh-requestsRefresh managed Mailgun DNS verification
DELETE/resellers/{reseller_id}/mailgunDelete the reseller Mailgun configuration
DELETE/resellers/{reseller_id}/mailgun/domains/{domain_id}Delete or detach a managed Mailgun domain

Fichiers et dossiers

Stockage de fichiers et organisation en dossiers. 11 endpoints.

Fichiers Files

Upload, recherche, mise à jour et suppression de fichiers. 6 endpoints.

MéthodeEndpointDescription
GET/filesFetch list
GET/files/{file_id}Find profile
POST/filesUpload a file
POST/files/{file_id}Update profile
POST/files/searchSearch files
DELETE/files/{file_id}Delete a file

Dossiers Folders

Organisation des ressources en dossiers. 5 endpoints.

MéthodeEndpointDescription
GET/foldersFetch list
GET/folders/{folder_id}Find profile
POST/foldersCreate a folder
PUT/folders/{folder_id}Update profile
DELETE/folders/{folder_id}Delete a folder

FAQ API Magileads V2 : API Magileads V2

Qu’est-ce que l’API Magileads ?

L’API Magileads est l’interface REST de la plateforme Magileads de prospection multicanale B2B. Décrite au format OpenAPI 3.0 (version 2.0.0), elle expose 505 endpoints couvrant le ciblage LinkedIn et Google Maps, l’enrichissement de contacts, les campagnes e-mail, LinkedIn et SMS, le PRM et les statistiques.

Quelle est l’URL de base de l’API Magileads ?

Toutes les requêtes sont envoyées vers https://app.api-magileads.net. Les réponses sont au format JSON et toutes les dates sont exprimées en GMT.

Comment s’authentifier sur l’API Magileads ?

La méthode la plus simple consiste à transmettre la clé d’API dans l’en-tête HTTP x-api-key. L’API propose aussi un serveur OAuth 2.0 (flux authorization code, rafraîchissement et révocation de jetons) pour les applications tierces.

Peut-on extraire des leads LinkedIn et Sales Navigator via l’API ?

Oui. Le groupe Targeting – LinkedIn compte 27 endpoints d’extraction : recherches LinkedIn et Sales Navigator (personnes et entreprises), connexions, membres de groupes, participants à des événements, visiteurs de profil, likers, commentateurs et repartageurs de posts.

L’API Magileads intègre-t-elle de l’intelligence artificielle ?

Oui. Des endpoints génèrent des modèles d’e-mails (texte et HTML), d’invitations et de messages LinkedIn, des briefs d’agents IA, des workflows complets par agent IA et des suggestions de réponse aux prospects dans le PRM.

Comment connecter Magileads à un CRM ou à un outil no-code ?

Via les webhooks, les hooks Zapier ou en interrogeant directement les endpoints PRM et Contact Lists. Les crons permettent de planifier des traitements récurrents.

L’API Magileads V2 est-elle disponible en marque blanche ?

Oui. Les groupes Resellers et Resellers – Mailgun permettent de gérer une instance en marque blanche : domaine SaaS, CNAME, messages transactionnels, options, utilisateurs et domaines d’envoi Mailgun.

Besoin d’aide pour votre intégration ? Contactez le support technique Magileads à co*****@*******ds.eu.

Quels services propose Magileads ?

Magileads propose des solutions de prospection omnicanale conçues pour répondre aux besoins spécifiques des entreprises. Notre équipe mise sur une technologie de pointe et un accompagnement stratégique pour générer des opportunités commerciales qualifiées.

Comment Magileads aide-t-elle à l'acquisition de clients ?

Nous simplifions le cycle de vente en automatisant la détection de prospects. Grâce à notre plateforme, vous pouvez cibler précisément vos futurs clients et engager la conversation au bon moment, avec le bon message.

Proposez-vous des outils d'automatisation marketing ?

Oui, notre plateforme intègre des outils de Marketing Automation permettant de scénariser vos prises de contact via email, LinkedIn et appels, tout en conservant une approche personnalisée et humaine.

Search