1. Listes de contacts
Conexteo API - Documentation SMS & RCS
FR
  • FR
  • EN
  • Introduction
  • Utilisateur
    • Crédits
      GET
  • Messages
    • Réponses
      • Réponses - pagination
      • Réponses - complet
    • RCS
      • Envoi RCS
    • SMS
      • Envoi Manuel
      • Envoi Dynamique
      • Envoi Liste de contacts
      • Envoi Fichier
    • Historique des messages
      GET
    • Détail d'un message
      GET
    • Annuler un message
      PUT
    • Destinataire(s) sms d'un message
      GET
    • Destinataire(s) sms d'un message
      GET
    • Destinataire(s) rcs d'un message
      GET
  • Modèle
    • Création du modèle Rcs
      POST
    • Création du modèle
      POST
    • Liste des modèles RCS
      GET
    • Liste des modèles
      GET
    • Mise à jour du modèle Rcs
      PUT
    • Mise à jour du modèle
      PUT
    • Détail du modèle RCS
      GET
    • Détail du modèle
      GET
    • Suppression
      DELETE
    • Suppression du modèle RCS
      DELETE
  • Webhooks
    • Rotation du secret de signature
    • Historique des livraisons de webhooks
    • Webhooks configurés du compte
    • Configuration des webhooks du compte
  • Stops
    • Liste des stops
    • Ajout d'un stop manuel
    • Ajout de stop(s) par fichier
    • Suppression d'un STOP
  • Listes de contacts
    • Créer une liste de contacts
      POST
    • Liste des listes de contacts
      GET
    • Mise à jour d'une liste de contacts
      PUT
    • Détail d'une liste de contacts
      GET
    • Suppression d'une liste de contacts
      DELETE
    • Contacts d'une liste de contacts - pagination
      GET
    • Contacts d'une liste de contacts - complet
      GET
    • Import asynchrone de contacts par fichier
      POST
    • Statut d'un import de contacts
      GET
    • Imports de contacts en cours
      GET
  • Contacts
    • Ajouter un/des contact(s)
    • Mise à jour d'un contact
    • Détail d'un contact
    • Suppression d'un contact
  • Sous-Comptes
    • Création Sous-Compte
    • Liste des Sous-Comptes
    • Liste des Sous-Comptes - pagination
    • Détail d'un Sous-Compte
    • Ajout crédits Sous-Compte
    • Suprression crédits Sous-Compte
    • Changement mode de consommation de crédits
    • Liste des crédits d'un sous-compte
  • Schemas
    • CreditsRo
    • Messages_type
    • Reponses
    • Messages
    • paginationMeta
    • RepliesHistoryRo
    • MessagesHistoryRo
    • SmsStatus
    • RcsStatus
    • CreateMessageStatusTypeRCS
    • SmsResume
    • StatusResumeBeforeRCS
    • RcsResume
    • CallChoiceDto
    • TextChoiceDto
    • UrlChoiceDto
    • LocationChoiceDto
    • RcsCardDto
    • RcsCarouselDto
    • RcsTextDto
    • RcsDtoBaseConfig
    • shortUrlDto
    • FallBack
    • RcsDto
    • CreateMessageStatusType
    • RcsConfig
    • statusResumeBefore
    • MessagesSimpleDto
    • ReplyExtractRo
    • MessagesDynamicDto
    • RcsChoices
    • MessagesContactListDto
    • ContactImportStartRo
    • MessagesFileUploadDto
    • ContactImportRo
    • Messages_sms
    • subAccountApiKeyRo
    • ApiKeyRegenerateDto
    • MessagesDestinatairesRo
    • Messages_rcs
    • MessagesDestinatairesRcsRo
    • Stops
    • StopsListRo
    • StopsDto
    • StopsFileUploadDto
    • ContactlistsDto
    • Contactlists
    • ContactlistsRemovedRO
    • ContactsWithId
    • ContactlistsContactsRo
    • Contacts
    • ContactsInsertDto
    • ContactsAddedRo
    • ContactsInsertByFileDto
    • ContactRemovedRO
    • LoginUserDto
    • LoginResponseDto
    • ModelsDto
    • Models
    • RcsCarousel
    • RcsShorturl
    • SubAccountCreateDto
    • subAccountWithCredentials
    • subAccount
    • SubAccountListRo
    • SubAccountCredits
    • SubAccountChangeModeCredits
    • WebhookSecretRo
    • WebhookDeliveryRo
    • WebhookDeliveriesRo
    • WebhookRo
    • webhookTypeDto
    • webhookDtoUpdate
    • WebhookConfigRo
  1. Listes de contacts

Import asynchrone de contacts par fichier

POST
/contact-lists/{contactlistId}/imports
Importe les contacts d'un fichier dans une liste existante. L'import est asynchrone : la réponse (HTTP 202) confirme seulement la prise en compte du fichier et renvoie l'identifiant de l'import (importId). Suivez ensuite l'avancement avec GET /contact-lists/{contactlistId}/imports/{importId} jusqu'à ce que le statut soit done ou failed.
Fichier : champ multipart « file », formats .csv, .xls et .xlsx (extension en minuscules), 500 Mo au plus. La première ligne contient les noms de colonnes ; pour un fichier xlsx, seule la première feuille est lue. Une colonne téléphone est obligatoire (en-têtes reconnus sans tenir compte des majuscules, espaces, tirets et points : telephone, tel, phone, phonenumber, portable, port, mobile, mobilephone, cell, cellphone). Sont aussi reconnues les colonnes nom (nom, name, lastname), prénom (prénom, prenom, firstname, givenname), adresse, mail, cp, ville, date et perso1 à perso10. Pour un csv, le séparateur virgule ou point-virgule est détecté, en UTF-8 ou en Windows-1252.
Les numéros déjà présents dans la liste ou répétés dans le fichier sont ignorés (comptés comme doublons) ; les numéros illisibles sont comptés comme échecs.

Request

Authorization
API Key
Add parameter in header
X-APP-ID
Example:
X-APP-ID: ********************
API Key
Add parameter in header
X-API-KEY
Example:
X-API-KEY: ********************
or
Path Params

Body Params multipart/form-dataRequired

Responses

🟢202Accepted
application/json
Import accepté
Bodyapplication/json

🟠400Bad Request
🟠401Unauthorized
🟠404Not Found
🔴503Service Unavailable
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.conexteo.com/contact-lists//imports' \
--header 'X-APP-ID: <api-key>' \
--header 'X-API-KEY: <api-key>' \
--form 'file=@""'
Response Response Example
{
    "importId": 42,
    "status": "pending"
}
Modified at 2026-11-04 15:22:25
Previous
Contacts d'une liste de contacts - complet
Next
Statut d'un import de contacts
Built with