Contacts

Gérez les profils de contacts et les champs personnalisés, en masse ou un par un.

URL de basehttps://api.emailit.com/v2Authentification Erreurs Limites de débit

POST/contacts
GET/contacts/{id}
POST/contacts/{id}
GET/contacts
POST/contacts/bulk
POST/contacts/{id}/tags
DEL/contacts/{id}/tags
GET/contacts/tags
POST/contacts/{id}/score
GET/contacts/export
DEL/contacts/{id}

Créer un contact

Crée un contact et l’inscrit éventuellement à des listes de contacts.

POST/contacts

Nécessite une clé API full. Les adresses e-mail sont uniques au sein d’un espace de travail et enregistrées en minuscules ; créer un contact qui existe déjà renvoie 409 avec le contact existant dans existing. Déclenche contact.created, et subscriber.created pour chaque liste. Consultez Contacts.

Paramètres du corps

emailstringobligatoire

L’adresse e-mail du contact.

first_namestring

Le prénom.

last_namestring

Le nom de famille.

custom_fieldsobject

Valeurs par clé de champ personnalisé, par exemple {"company": "Analytical Engines"}. Les valeurs des champs de type date doivent être au format YYYY-MM-DD. Les clés qui ne correspondent à aucun champ personnalisé sont enregistrées telles quelles.

audiencesstring[]

ID des listes (aud_…) auxquelles inscrire le contact. Les ID qui n’existent pas dans l’espace de travail sont ignorés.

tagsstring[]

50 tags au maximum, enregistrés en minuscules.

scoreintegerpar défaut : 0

Le score de lead initial du contact.

unsubscribedbooleanpar défaut : false

true pour créer le contact à l’état désinscrit. Les campagnes ignorent les contacts désinscrits, et leurs inscriptions aux listes sont créées à l’état désinscrit.

Réponse

Renvoie 201 avec l’objet contact. Ici, audiences contient chaque liste avec son id, son name et son statut subscribed. Pour tous les champs, consultez Récupérer un contact.

Renvoie 422 avec usage lorsqu’une liste a atteint la limite d’abonnés de votre forfait. Dans ce cas, aucun contact n’est créé.

POST/contacts

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const contact = await emailit.contacts.create({
  email: 'ada@example.com',
  first_name: 'Ada',
  last_name: 'Lovelace',
});

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

contact = client.contacts.create({
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
})

PHP

$emailit = Emailit::client('your_api_key');

$contact = $emailit->contacts()->create([
  'email' => 'ada@example.com',
  'first_name' => 'Ada',
  'last_name' => 'Lovelace',
]);

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

contact = client.contacts.create(
  email: "ada@example.com",
  first_name: "Ada",
  last_name: "Lovelace"
)

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

contact, err := client.Contacts.Create(&emailit.CreateContactRequest{
  Email:     "ada@example.com",
  FirstName: "Ada",
  LastName:  "Lovelace",
})

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let contact = emailit.contacts.create(
  emailit::types::CreateContactParams::new("ada@example.com")
    .with_first_name("Ada")
    .with_last_name("Lovelace")
).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject contact = emailit.contacts().create(
  ContactCreateParams.builder()
    .setEmail("ada@example.com")
    .setFirstName("Ada")
    .setLastName("Lovelace")
    .build()
);

using Emailit;

var emailit = new EmailitClient("your_api_key");

var contact = emailit.Contacts.Create(new ContactCreateOptions {
  Email = "ada@example.com",
  FirstName = "Ada",
  LastName = "Lovelace",
});

PHP

use Emailit\Laravel\Facades\Emailit;

$contact = Emailit::contacts()->create([
  'email' => 'ada@example.com',
  'first_name' => 'Ada',
  'last_name' => 'Lovelace',
]);

Terminal

curl -X POST https://api.emailit.com/v2/contacts \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": { "company": "Analytical Engines", "plan": "pro" },
    "audiences": ["aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2"]
  }'

JSON

{
  "object": "contact",
  "id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": {
    "company": "Analytical Engines",
    "plan": "pro"
  },
  "unsubscribed": false,
  "audiences": [
    {
      "id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
      "name": "Newsletter",
      "subscribed": true
    }
  ],
  "created_at": "2026-10-01T10:20:31.704113Z",
  "updated_at": "2026-10-01T10:20:31.704113Z"
}

JSON

{
  "error": "Custom field \"Birthday\" must be a date in YYYY-MM-DD format"
}

JSON

{
  "error": "Contact with this email already exists",
  "existing": {
    "object": "contact",
    "id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": {
      "company": "Analytical Engines",
      "plan": "pro"
    },
    "unsubscribed": false,
    "audiences": [
      {
        "id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
        "name": "Newsletter",
        "subscribed": true
      }
    ],
    "created_at": "2026-10-01T10:20:31.704113Z",
    "updated_at": "2026-10-01T10:20:31.704113Z"
  }
}

JSON

{
  "error": "Pro includes 50,000 subscribers per audience.",
  "usage": {
    "used": 50000,
    "limit": 50000,
    "plan": "pro"
  }
}

Récupérer un contact

Récupère un contact avec ses champs personnalisés et ses inscriptions aux listes de contacts.

GET/contacts/{id}

Nécessite une clé API full.

Paramètres de chemin

idstringobligatoire

L’ID du contact (con_…) ou son adresse e-mail, encodée pour l’URL.

Réponse

Renvoie l’objet contact.

objectstring

Toujours contact.

idstring

L’ID du contact.

emailstring

L’adresse e-mail, en minuscules.

first_namestring | null

Le prénom.

last_namestring | null

Le nom de famille.

custom_fieldsobject

Valeurs des champs personnalisés par clé. {} s’il n’y en a aucun.

unsubscribedboolean

true si le contact s’est désinscrit de toutes les campagnes.

tagsstring[]

Les tags du contact, en minuscules et triés.

scoreinteger

Le score de lead du contact.

audiencesobject[]

Les listes de contacts auxquelles appartient le contact, chacune avec id, name et un objet subscriber : id (sub_…), subscribed, subscribed_at, unsubscribed_at, created_at et updated_at.

created_atstring

Date de création du contact.

updated_atstring

Date de la dernière modification du contact.

GET/contacts/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const contact = await emailit.contacts.get('con_4K9kQdrXth7am0TPKvPrR5yd2oo');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

contact = client.contacts.get("con_4K9kQdrXth7am0TPKvPrR5yd2oo")

PHP

$emailit = Emailit::client('your_api_key');

$contact = $emailit->contacts()->get('con_4K9kQdrXth7am0TPKvPrR5yd2oo');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

contact = client.contacts.get("con_4K9kQdrXth7am0TPKvPrR5yd2oo")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

contact, err := client.Contacts.Get("con_4K9kQdrXth7am0TPKvPrR5yd2oo")

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let contact = emailit.contacts.get("con_4K9kQdrXth7am0TPKvPrR5yd2oo").await?;

Java

import com.emailit.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject contact = emailit.contacts().get("con_4K9kQdrXth7am0TPKvPrR5yd2oo");

using Emailit;

var emailit = new EmailitClient("your_api_key");

var contact = emailit.Contacts.Get("con_4K9kQdrXth7am0TPKvPrR5yd2oo");

PHP

use Emailit\Laravel\Facades\Emailit;

$contact = Emailit::contacts()->get('con_4K9kQdrXth7am0TPKvPrR5yd2oo');

Terminal

curl https://api.emailit.com/v2/contacts/con_4K9kQdrXth7am0TPKvPrR5yd2oo \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JSON

{
  "object": "contact",
  "id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": {
    "company": "Analytical Engines",
    "plan": "pro"
  },
  "unsubscribed": false,
  "audiences": [
    {
      "id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
      "name": "Newsletter",
      "subscriber": {
        "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
        "subscribed": true,
        "subscribed_at": "2026-10-01T10:20:31.000000Z",
        "unsubscribed_at": null,
        "created_at": "2026-10-01T10:20:31.000000Z",
        "updated_at": "2026-10-01T10:20:31.000000Z"
      }
    }
  ],
  "created_at": "2026-10-01T10:20:31.000000Z",
  "updated_at": "2026-10-01T10:20:31.000000Z"
}

JSON

{
  "error": "Contact not found"
}

Mettre à jour un contact

Met à jour un contact. Seuls les champs que vous envoyez sont modifiés.

POST/contacts/{id}

Nécessite une clé API full. Déclenche contact.updated, avec les valeurs précédentes des champs modifiés dans previous. Modifier audiences déclenche aussi subscriber.created et subscriber.deleted pour les inscriptions ajoutées et supprimées.

Paramètres de chemin

idstringobligatoire

L’ID du contact (con_…) ou son adresse e-mail, encodée pour l’URL.

Paramètres du corps

emailstring

Une nouvelle adresse e-mail. Ne doit pas appartenir à un autre contact.

first_namestring

Le prénom.

last_namestring

Le nom de famille.

custom_fieldsobject

Valeurs des champs personnalisés par clé. Remplacent tous les champs personnalisés du contact : incluez ceux que vous voulez conserver.

unsubscribedboolean

true pour désinscrire le contact de toutes les campagnes, false pour le réinscrire. Les inscriptions existantes aux listes conservent leur propre statut.

tagsstring[]

Remplace tous les tags du contact. [] les retire tous.

add_tagsstring[]

Les tags à ajouter, en conservant les autres.

remove_tagsstring[]

Les tags à retirer.

scoreinteger

Définit le score de lead. Pour ajouter ou retirer des points, utilisez Modifier le score de lead d’un contact.

audiencesstring[]

La liste complète des ID des listes de contacts auxquelles le contact doit appartenir. Le contact est ajouté aux listes dont il ne fait pas encore partie et retiré de celles qui ne figurent pas dans votre tableau. Envoyez [] pour le retirer de toutes les listes. Pour ajouter ou retirer une seule liste sans les énumérer toutes, utilisez Ajouter un abonné ou Supprimer un abonné.

Réponse

Renvoie le contact mis à jour, au même format que Récupérer un contact. Une requête sans aucun de ces champs renvoie 400.

POST/contacts/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const contact = await emailit.contacts.update('con_4K9kQdrXth7am0TPKvPrR5yd2oo', {
  first_name: 'Augusta',
});

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

contact = client.contacts.update("con_4K9kQdrXth7am0TPKvPrR5yd2oo", {
  "first_name": "Augusta",
})

PHP

$emailit = Emailit::client('your_api_key');

$contact = $emailit->contacts()->update('con_4K9kQdrXth7am0TPKvPrR5yd2oo', [
  'first_name' => 'Augusta',
]);

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

contact = client.contacts.update("con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  first_name: "Augusta"
)

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

contact, err := client.Contacts.Update("con_4K9kQdrXth7am0TPKvPrR5yd2oo", &emailit.UpdateContactRequest{
  FirstName: "Augusta",
})

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let contact = emailit.contacts.update("con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  emailit::types::UpdateContactParams {
    first_name: Some("Augusta".into()),
    ..Default::default()
  }
).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject contact = emailit.contacts().update("con_4K9kQdrXth7am0TPKvPrR5yd2oo", 
  ContactUpdateParams.builder()
    .setFirstName("Augusta")
    .build()
);

using Emailit;

var emailit = new EmailitClient("your_api_key");

var contact = emailit.Contacts.Update("con_4K9kQdrXth7am0TPKvPrR5yd2oo", new ContactUpdateOptions {
  FirstName = "Augusta",
});

PHP

use Emailit\Laravel\Facades\Emailit;

$contact = Emailit::contacts()->update('con_4K9kQdrXth7am0TPKvPrR5yd2oo', [
  'first_name' => 'Augusta',
]);

Terminal

curl -X POST https://api.emailit.com/v2/contacts/con_4K9kQdrXth7am0TPKvPrR5yd2oo \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Augusta"}'

Terminal

curl -X POST https://api.emailit.com/v2/contacts/ada%40example.com \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_fields": { "company": "Analytical Engines", "plan": "business" },
    "audiences": ["aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "aud_4KOlh9t2uw5od4qypqCtyrZyDq2"]
  }'

JSON

{
  "object": "contact",
  "id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  "email": "ada@example.com",
  "first_name": "Augusta",
  "last_name": "Lovelace",
  "custom_fields": {
    "company": "Analytical Engines",
    "plan": "pro"
  },
  "unsubscribed": false,
  "audiences": [
    {
      "id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
      "name": "Newsletter",
      "subscriber": {
        "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
        "subscribed": true,
        "subscribed_at": "2026-10-01T10:20:31.000000Z",
        "unsubscribed_at": null,
        "created_at": "2026-10-01T10:20:31.000000Z",
        "updated_at": "2026-10-01T10:20:31.000000Z"
      }
    }
  ],
  "created_at": "2026-10-01T10:20:31.000000Z",
  "updated_at": "2026-10-02T09:03:17.000000Z"
}

JSON

{
  "error": "No valid fields provided for update. Provide at least one of: email, first_name, last_name, custom_fields, unsubscribed, audiences"
}

JSON

{
  "error": "Contact not found"
}

JSON

{
  "error": "Another contact with this email already exists"
}

Lister les contacts

Renvoie une page de contacts, du plus récent au plus ancien.

GET/contacts

Nécessite une clé API full. Utilisez les mêmes paramètres avec Exporter des contacts pour télécharger tous les résultats dans un fichier.

Paramètres de requête

pageintegerpar défaut : 1

La page à renvoyer.

limitintegerpar défaut : 10

Nombre de contacts par page, de 1 à 100.

searchstring

Recherche insensible à la casse sur l’adresse e-mail, le prénom ou le nom de famille. q fonctionne aussi.

audience_idstring

Uniquement les contacts de cette liste (aud_…).

unsubscribedboolean

true ou false. Uniquement les contacts ayant ce statut de désinscription.

filter[tag]string

Uniquement les contacts qui ont ce tag. Séparez plusieurs tags par des virgules pour obtenir les contacts qui en ont au moins un. tag fonctionne aussi.

filter[score][gte], filter[score][lte]integer

Uniquement les contacts dont le score de lead est au moins ou au plus égal à cette valeur.

sortstringpar défaut : created_at

email, first_name, last_name, name, audiences, score, created_at ou updated_at.

orderstringpar défaut : desc

asc ou desc. Sur cet endpoint, order est le sens du tri, pas la clé de tri.

matchstringpar défaut : all

all ou or. Mode de combinaison des filtres ci-dessous.

Filtres

Ajoutez des filtres sous la forme key.condition=value, par exemple email.ends_with=@acme.com ou custom_fields.plan.exact=pro. Consultez Filtrage et tri.

Clé	Type	Remarques
`email`	chaîne
`first_name`	chaîne
`last_name`	chaîne
`name`	chaîne	Prénom et nom de famille séparés par une espace.
`audiences`	chaîne	Le premier nom de liste du contact dans l’ordre alphabétique.
`unsubscribed`	booléen
`created_at`	date
`updated_at`	date
`audience_id`	chaîne	Uniquement `exact` et `not_exact`. La valeur est un ID de liste.
`custom_fields.<key>`	chaîne	Remplacez `<key>` par la clé d’un champ personnalisé. Les valeurs sont comparées comme du texte.

Les anciens paramètres filter[audience_id], filter[unsubscribed] et filter[custom_fields][<key>] fonctionnent toujours.

Réponse

dataobject[]

Les contacts de cette page, chacun avec audiences sous la forme id, name et subscribed. Consultez Récupérer un contact.

total_recordsinteger

Le nombre de contacts correspondants, toutes pages confondues.

next_page_urlstring | null

Chemin de la page suivante avec vos filtres, ou null. Consultez Pagination.

previous_page_urlstring | null

Chemin de la page précédente, ou null.

GET/contacts

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const contacts = await emailit.contacts.list();

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

contacts = client.contacts.list()

PHP

$emailit = Emailit::client('your_api_key');

$contacts = $emailit->contacts()->list();

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

contacts = client.contacts.list

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

contacts, err := client.Contacts.List(nil)

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let contacts = emailit.contacts.list(None).await?;

Java

import com.emailit.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject contacts = emailit.contacts().list();

using Emailit;

var emailit = new EmailitClient("your_api_key");

var contacts = emailit.Contacts.List();

PHP

use Emailit\Laravel\Facades\Emailit;

$contacts = Emailit::contacts()->list();

Terminal

curl https://api.emailit.com/v2/contacts \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Terminal

curl -G https://api.emailit.com/v2/contacts \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2" \
  --data-urlencode "custom_fields.plan.exact=pro" \
  --data-urlencode "sort=email" \
  --data-urlencode "order=asc" \
  --data-urlencode "limit=100"

JSON

{
  "data": [
    {
      "object": "contact",
      "id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines",
        "plan": "pro"
      },
      "unsubscribed": false,
      "audiences": [
        {
          "id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
          "name": "Newsletter",
          "subscribed": true
        }
      ],
      "created_at": "2026-10-01T10:20:31.704113Z",
      "updated_at": "2026-10-01T10:20:31.704113Z"
    },
    {
      "object": "contact",
      "id": "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7",
      "email": "grace@example.com",
      "first_name": "Grace",
      "last_name": "Hopper",
      "custom_fields": {},
      "unsubscribed": true,
      "audiences": [],
      "created_at": "2026-09-28T07:55:02.118342Z",
      "updated_at": "2026-09-30T18:11:40.902215Z"
    }
  ],
  "total_records": 2,
  "next_page_url": null,
  "previous_page_url": null
}

Mettre à jour des contacts en masse

Exécute une action sur 100 contacts au maximum en une seule requête.

POST/contacts/bulk

Nécessite une clé API full. Chaque ID doit correspondre à un contact de l’espace de travail ; sinon, rien n’est modifié et la réponse indique les ID manquants dans missing. Chaque contact déclenche les mêmes événements qu’avec les endpoints portant sur un seul contact. Si la liste de contacts atteint la limite d’abonnés de votre forfait pendant add_to_audience, la requête s’arrête avec 422, et les contacts traités jusque-là restent ajoutés.

Action	Effet
`delete`	Supprime les contacts et leurs inscriptions aux listes, comme Supprimer un contact.
`add_to_audience`	Ajoute les contacts à `audience_id`. Les contacts qui y figurent déjà restent inchangés.
`remove_from_audience`	Retire les contacts de `audience_id`.
`unsubscribe`	Définit `unsubscribed` sur `true` : les campagnes ignorent alors ces contacts.
`resubscribe`	Définit `unsubscribed` sur `false`.

Paramètres du corps

actionstringobligatoire

delete, add_to_audience, remove_from_audience, unsubscribe ou resubscribe.

idsstring[]obligatoire

ID de contacts (con_…), de 1 à 100. Les adresses e-mail ne sont pas acceptées ici. Les doublons sont ignorés.

audience_idstring

L’ID de la liste. Obligatoire pour add_to_audience et remove_from_audience.

Réponse

objectstring

Toujours contact_bulk.

actionstring

L’action exécutée.

processedinteger

Nombre de contacts traités.

idsstring[]

Les ID des contacts traités.

POST/contacts/bulk

JavaScript

const response = await fetch('https://api.emailit.com/v2/contacts/bulk', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer your_api_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"action": "add_to_audience", "ids": ["con_4K9kQdrXth7am0TPKvPrR5yd2oo", "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7"], "audience_id": "aud_4KOlh9t2uw5od4qypqCtyrZyDq2"}),
});
const result = await response.json();

Python

import requests

response = requests.post(
  "https://api.emailit.com/v2/contacts/bulk",
  headers={"Authorization": "Bearer your_api_key"},
  json={"action": "add_to_audience", "ids": ["con_4K9kQdrXth7am0TPKvPrR5yd2oo", "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7"], "audience_id": "aud_4KOlh9t2uw5od4qypqCtyrZyDq2"}
)
result = response.json()

PHP

$ch = curl_init('https://api.emailit.com/v2/contacts/bulk');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer your_api_key',
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode(['action' => 'add_to_audience', 'ids' => ['con_4K9kQdrXth7am0TPKvPrR5yd2oo', 'con_4KiXIs4xLTcJIAHnKJaLcnMZYh7'], 'audience_id' => 'aud_4KOlh9t2uw5od4qypqCtyrZyDq2']),
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

Ruby

require "net/http"
require "json"

uri = URI("https://api.emailit.com/v2/contacts/bulk")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer your_api_key"
req["Content-Type"] = "application/json"
req.body = { action: "add_to_audience", ids: ["con_4K9kQdrXth7am0TPKvPrR5yd2oo", "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7"], audience_id: "aud_4KOlh9t2uw5od4qypqCtyrZyDq2" }.to_json
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
result = JSON.parse(http.request(req).body)

payload := strings.NewReader(`{"action": "add_to_audience", "ids": ["con_4K9kQdrXth7am0TPKvPrR5yd2oo", "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7"], "audience_id": "aud_4KOlh9t2uw5od4qypqCtyrZyDq2"}`)
req, _ := http.NewRequest("POST", "https://api.emailit.com/v2/contacts/bulk", payload)
req.Header.Set("Authorization", "Bearer your_api_key")
req.Header.Set("Content-Type", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil {
  return err
}
defer resp.Body.Close()

Rust

let response = reqwest::Client::new()
    .post("https://api.emailit.com/v2/contacts/bulk")
    .bearer_auth("your_api_key")
    .json(&serde_json::json!({"action": "add_to_audience", "ids": ["con_4K9kQdrXth7am0TPKvPrR5yd2oo", "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7"], "audience_id": "aud_4KOlh9t2uw5od4qypqCtyrZyDq2"}))
    .send()
    .await?;

Java

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create("https://api.emailit.com/v2/contacts/bulk"))
  .header("Authorization", "Bearer your_api_key")
  .header("Content-Type", "application/json")
  .POST(HttpRequest.BodyPublishers.ofString("{\"action\": \"add_to_audience\", \"ids\": [\"con_4K9kQdrXth7am0TPKvPrR5yd2oo\", \"con_4KiXIs4xLTcJIAHnKJaLcnMZYh7\"], \"audience_id\": \"aud_4KOlh9t2uw5od4qypqCtyrZyDq2\"}"))
  .build();
HttpResponse<String> response = client.send(request,
  HttpResponse.BodyHandlers.ofString());

using System.Net.Http.Headers;
using System.Text;

var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "your_api_key");

var content = new StringContent(@"{""action"": ""add_to_audience"", ""ids"": [""con_4K9kQdrXth7am0TPKvPrR5yd2oo"", ""con_4KiXIs4xLTcJIAHnKJaLcnMZYh7""], ""audience_id"": ""aud_4KOlh9t2uw5od4qypqCtyrZyDq2""}", Encoding.UTF8, "application/json");
var response = await http.PostAsync("https://api.emailit.com/v2/contacts/bulk", content);

PHP

use Illuminate\Support\Facades\Http;

$result = Http::withToken('your_api_key')
  ->post('https://api.emailit.com/v2/contacts/bulk', ['action' => 'add_to_audience', 'ids' => ['con_4K9kQdrXth7am0TPKvPrR5yd2oo', 'con_4KiXIs4xLTcJIAHnKJaLcnMZYh7'], 'audience_id' => 'aud_4KOlh9t2uw5od4qypqCtyrZyDq2'])
  ->json();

Terminal

curl -X POST https://api.emailit.com/v2/contacts/bulk \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action": "add_to_audience", "ids": ["con_4K9kQdrXth7am0TPKvPrR5yd2oo", "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7"], "audience_id": "aud_4KOlh9t2uw5od4qypqCtyrZyDq2"}'

JSON

{
  "object": "contact_bulk",
  "action": "add_to_audience",
  "processed": 2,
  "ids": ["con_4K9kQdrXth7am0TPKvPrR5yd2oo", "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7"]
}

JSON

{
  "error": "A maximum of 100 contacts can be updated per request"
}

JSON

{
  "error": "One or more contacts were not found",
  "missing": ["con_4K3pZc1Q9nWm2LrT8vYb5Hd0XaE"]
}

JSON

{
  "error": "Pro includes 50,000 subscribers per audience.",
  "usage": {
    "used": 50000,
    "limit": 50000,
    "plan": "pro"
  }
}

Ajouter des tags à un contact

Ajoute des tags à un contact. Les tags que le contact a déjà restent inchangés. Nécessite une clé API de portée full.

Les tags sont débarrassés des espaces en début et en fin, enregistrés en minuscules avec les suites d’espaces réduites à une seule, et comptent 64 caractères au maximum. Quand au moins un tag est nouveau, Emailit envoie un événement contact.updated avec les nouveaux tags et les anciens dans previous.tags, ce qui démarre les automatisations Tag added. Consultez Tags et score de lead.

POST/contacts/{id}/tags

Paramètres de chemin

idstringobligatoire

L’ID du contact (con_…) ou son adresse e-mail, encodée pour l’URL.

Paramètres du corps

tagsstring[]obligatoire

Les tags à ajouter, 50 au maximum.

Réponse

dataobject

L’id et l’email du contact, tous ses tags après la modification, et changed, les tags ajoutés.

messagestring

Par exemple 1 tag added. ou No tags changed.

Renvoie 400 quand un tag est vide ou dépasse 64 caractères, et 404 si le contact n’existe pas.

JSON

{
  "data": {
    "id": "con_2kq8Vt4xLm7Rz",
    "email": "ada@example.com",
    "tags": ["customer", "vip", "webinar-2026"],
    "changed": ["customer", "webinar-2026"]
  },
  "message": "2 tags added."
}

POST/contacts/{id}/tags

Terminal

curl -X POST https://api.emailit.com/v2/contacts/ada@example.com/tags \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tags": ["customer", "webinar-2026"]}'

JavaScript

const res = await fetch('https://api.emailit.com/v2/contacts/ada@example.com/tags', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"tags": ["customer", "webinar-2026"]}),
});
const result = await res.json();

Python

import os, requests

r = requests.post(
    "https://api.emailit.com/v2/contacts/ada@example.com/tags",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
    json={"tags": ["customer", "webinar-2026"]},
)
result = r.json()

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://api.emailit.com/v2/']);

$response = $client->post('contacts/ada@example.com/tags', [
    'headers' => ['Authorization' => 'Bearer ' . getenv('EMAILIT_API_KEY')],
    'json' => ['tags' => ['customer', 'webinar-2026']],
]);
$result = json_decode($response->getBody(), true);

Retirer des tags d’un contact

Retire des tags d’un contact. Les tags que le contact n’a pas sont ignorés. Nécessite une clé API de portée full.

Quand au moins un tag est retiré, Emailit envoie un événement contact.updated avec previous.tags, ce qui démarre les automatisations Tag removed. Consultez Tags et score de lead.

DELETE/contacts/{id}/tags

Paramètres de chemin

idstringobligatoire

L’ID du contact (con_…) ou son adresse e-mail, encodée pour l’URL.

Paramètres du corps

tagsstring[]obligatoire

Les tags à retirer, 50 au maximum. Comparés en minuscules.

Réponse

dataobject

L’id et l’email du contact, ses tags restants, et changed, les tags retirés.

messagestring

Par exemple 1 tag removed. ou No tags changed.

Renvoie 404 si le contact n’existe pas.

DELETE/contacts/{id}/tags

Terminal

curl -X DELETE https://api.emailit.com/v2/contacts/con_2kq8Vt4xLm7Rz/tags \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tags": ["trial"]}'

JavaScript

const res = await fetch('https://api.emailit.com/v2/contacts/con_2kq8Vt4xLm7Rz/tags', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"tags": ["trial"]}),
});
const result = await res.json();

Python

import os, requests

r = requests.delete(
    "https://api.emailit.com/v2/contacts/con_2kq8Vt4xLm7Rz/tags",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
    json={"tags": ["trial"]},
)
result = r.json()

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://api.emailit.com/v2/']);

$response = $client->delete('contacts/con_2kq8Vt4xLm7Rz/tags', [
    'headers' => ['Authorization' => 'Bearer ' . getenv('EMAILIT_API_KEY')],
    'json' => ['tags' => ['trial']],
]);
$result = json_decode($response->getBody(), true);

Renvoie les tags utilisés sur les contacts de l’espace de travail, par ordre alphabétique, avec le nombre de contacts qui portent chacun d’eux. Nécessite une clé API de portée full. Pour lister les contacts qui ont un tag, utilisez Lister les contacts avec filter[tag].

GET/contacts/tags

Paramètres de requête

searchstring

Uniquement les tags qui contiennent ce texte.

limitintegerpar défaut : 200

Nombre de tags à renvoyer, de 1 à 1 000.

Réponse

dataobject[]

Chaque tag, sous la forme { "object": "tag", "tag": "customer", "contacts": 42 }.

GET/contacts/tags

Terminal

curl "https://api.emailit.com/v2/contacts/tags?search=web" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JavaScript

const res = await fetch('https://api.emailit.com/v2/contacts/tags?search=web', {
  method: 'GET',
  headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}` },
});
const result = await res.json();

Python

import os, requests

r = requests.get(
    "https://api.emailit.com/v2/contacts/tags?search=web",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
)
result = r.json()

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://api.emailit.com/v2/']);

$response = $client->get('contacts/tags?search=web', [
    'headers' => ['Authorization' => 'Bearer ' . getenv('EMAILIT_API_KEY')],
]);
$result = json_decode($response->getBody(), true);

Modifier le score de lead d’un contact

Ajoute des points au score de lead d’un contact, en retire, ou le définit. Nécessite une clé API de portée full.

La modification est atomique : des appels simultanés ne s’écrasent pas les uns les autres. Le score part de 0, peut être négatif et reste compris entre −1 000 000 000 et +1 000 000 000. Quand le score change, Emailit envoie un événement contact.updated avec score et previous.score, ce qui démarre les automatisations Score changed. Consultez Tags et score de lead.

POST/contacts/{id}/score

Paramètres de chemin

idstringobligatoire

L’ID du contact (con_…) ou son adresse e-mail, encodée pour l’URL.

Paramètres du corps

operationstringpar défaut : add

add, subtract ou set.

valueintegerobligatoire

Les points à ajouter ou à retirer, ou le nouveau score.

Réponse

dataobject

L’id et l’email du contact, le nouveau score et le previous_score.

messagestring

Par exemple Score is now 55.

Renvoie 400 quand operation ou value n’est pas valide, et 404 si le contact n’existe pas.

JSON

{
  "data": { "id": "con_2kq8Vt4xLm7Rz", "email": "ada@example.com", "score": 55, "previous_score": 45 },
  "message": "Score is now 55."
}

POST/contacts/{id}/score

Terminal

curl -X POST https://api.emailit.com/v2/contacts/con_2kq8Vt4xLm7Rz/score \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operation": "add", "value": 10}'

JavaScript

const res = await fetch('https://api.emailit.com/v2/contacts/con_2kq8Vt4xLm7Rz/score', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"operation": "add", "value": 10}),
});
const result = await res.json();

Python

import os, requests

r = requests.post(
    "https://api.emailit.com/v2/contacts/con_2kq8Vt4xLm7Rz/score",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
    json={"operation": "add", "value": 10},
)
result = r.json()

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://api.emailit.com/v2/']);

$response = $client->post('contacts/con_2kq8Vt4xLm7Rz/score', [
    'headers' => ['Authorization' => 'Bearer ' . getenv('EMAILIT_API_KEY')],
    'json' => ['operation' => 'add', 'value' => 10],
]);
$result = json_decode($response->getBody(), true);

Exporter des contacts

Télécharge les contacts correspondants dans un fichier CSV ou XLSX.

GET/contacts/export

Nécessite une clé API full. Accepte les mêmes paramètres de recherche, de filtre et de tri que Lister les contacts, transmis dans la chaîne de requête, sans pagination. POST /contacts/export fonctionne de la même manière. Un export peut inclure 10 000 contacts au maximum ; si davantage de contacts correspondent, la requête renvoie 422 : affinez alors les filtres.

Paramètres de requête

formatstringpar défaut : csv

csv ou xlsx.

search, audience_id, unsubscribed, sort, order, match, key.conditionstring

Les mêmes paramètres que Lister les contacts.

Réponse

Renvoie le fichier en pièce jointe : contacts.csv (text/csv; charset=utf-8) ou contacts.xlsx. Chaque ligne correspond à un contact, avec les colonnes suivantes :

Colonne	Contenu
`email`	L’adresse e-mail.
`first_name`, `last_name`	Le prénom et le nom de famille.
`unsubscribed`	`true` ou `false`.
`audiences`	Les noms des listes du contact, séparés par `;` .
`tags`	Les tags du contact, séparés par `;` .
`score`	Le score de lead.
Une colonne par champ personnalisé	La valeur de chaque champ personnalisé défini dans l’espace de travail ; la colonne porte le nom de sa clé. Les listes de valeurs sont jointes par `;`.
`created_at`, `updated_at`	Horodatages ISO 8601.

GET/contacts/export

JavaScript

import { writeFile } from 'node:fs/promises';

const response = await fetch('https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', {
  headers: { Authorization: 'Bearer your_api_key' },
});
await writeFile('contacts.csv', Buffer.from(await response.arrayBuffer()));

Python

import requests

response = requests.get(
  "https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  headers={"Authorization": "Bearer your_api_key"}
)
with open("contacts.csv", "wb") as f:
    f.write(response.content)

PHP

$ch = curl_init('https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer your_api_key',
  ],
]);
file_put_contents('contacts.csv', curl_exec($ch));
curl_close($ch);

Ruby

require "net/http"

uri = URI("https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer your_api_key"
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
File.binwrite("contacts.csv", http.request(req).body)

req, _ := http.NewRequest("GET", "https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", nil)
req.Header.Set("Authorization", "Bearer your_api_key")

resp, err := http.DefaultClient.Do(req)
if err != nil {
  return err
}
defer resp.Body.Close()

out, _ := os.Create("contacts.csv")
defer out.Close()
io.Copy(out, resp.Body)

Rust

let bytes = reqwest::Client::new()
    .get("https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2")
    .bearer_auth("your_api_key")
    .send()
    .await?
    .bytes()
    .await?;
std::fs::write("contacts.csv", &bytes)?;

Java

import java.net.http.*;
import java.net.URI;
import java.nio.file.Path;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create("https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2"))
  .header("Authorization", "Bearer your_api_key")
  .GET()
  .build();
client.send(request, HttpResponse.BodyHandlers.ofFile(Path.of("contacts.csv")));

using System.Net.Http.Headers;

var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "your_api_key");

var bytes = await http.GetByteArrayAsync("https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2");
await File.WriteAllBytesAsync("contacts.csv", bytes);

PHP

use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Storage;

$csv = Http::withToken('your_api_key')
  ->get('https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2')
  ->body();
Storage::put('contacts.csv', $csv);

Terminal

curl "https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2" \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -o contacts.csv

Text

email,first_name,last_name,unsubscribed,audiences,company,plan,created_at,updated_at
ada@example.com,Ada,Lovelace,false,Newsletter,Analytical Engines,pro,2026-10-01T10:20:31.000000Z,2026-10-01T10:20:31.000000Z

JSON

{
  "error": "format must be csv or xlsx"
}

JSON

{
  "error": "Export is limited to 10000 contacts. Narrow your filters and try again."
}

Supprimer un contact

Supprime définitivement un contact et toutes ses inscriptions aux listes.

DELETE/contacts/{id}

Nécessite une clé API full. La suppression est irréversible. Pour ne plus envoyer d’e-mails à une personne tout en conservant sa fiche, mettez à jour le contact avec unsubscribed: true, ou ajoutez l’adresse à vos adresses bloquées. Déclenche subscriber.deleted pour chaque inscription, puis contact.deleted.

Paramètres de chemin

idstringobligatoire

L’ID du contact (con_…) ou son adresse e-mail, encodée pour l’URL.

Réponse

objectstring

Toujours contact.

idstring

L’ID du contact supprimé.

emailstring

L’adresse e-mail du contact.

deletedboolean

Toujours true.

DELETE/contacts/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

await emailit.contacts.delete('con_4Kt4ZXloQR8WGcMsYx8PFCUjokM');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

client.contacts.delete("con_4Kt4ZXloQR8WGcMsYx8PFCUjokM")

PHP

$emailit = Emailit::client('your_api_key');

$emailit->contacts()->delete('con_4Kt4ZXloQR8WGcMsYx8PFCUjokM');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

client.contacts.delete("con_4Kt4ZXloQR8WGcMsYx8PFCUjokM")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

err := client.Contacts.Delete("con_4Kt4ZXloQR8WGcMsYx8PFCUjokM")

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

emailit.contacts.delete("con_4Kt4ZXloQR8WGcMsYx8PFCUjokM").await?;

Java

import com.emailit.*;

EmailitClient emailit = new EmailitClient("your_api_key");

emailit.contacts().delete("con_4Kt4ZXloQR8WGcMsYx8PFCUjokM");

using Emailit;

var emailit = new EmailitClient("your_api_key");

emailit.Contacts.Delete("con_4Kt4ZXloQR8WGcMsYx8PFCUjokM");

PHP

use Emailit\Laravel\Facades\Emailit;

Emailit::contacts()->delete('con_4Kt4ZXloQR8WGcMsYx8PFCUjokM');

Terminal

curl -X DELETE https://api.emailit.com/v2/contacts/con_4Kt4ZXloQR8WGcMsYx8PFCUjokM \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JSON

{
  "object": "contact",
  "id": "con_4Kt4ZXloQR8WGcMsYx8PFCUjokM",
  "email": "alan@example.com",
  "deleted": true
}

JSON

{
  "error": "Contact not found"
}

Créer un contact

Paramètres du corps

Réponse

Récupérer un contact

Paramètres de chemin

Réponse

Mettre à jour un contact

Paramètres de chemin

Paramètres du corps

Réponse

Lister les contacts

Paramètres de requête

Filtres

Réponse

Mettre à jour des contacts en masse

Paramètres du corps

Réponse

Ajouter des tags à un contact

Paramètres de chemin

Paramètres du corps

Réponse

Retirer des tags d’un contact

Paramètres de chemin

Paramètres du corps

Réponse

Lister les tags

Paramètres de requête

Réponse

Modifier le score de lead d’un contact

Paramètres de chemin

Paramètres du corps

Réponse

Exporter des contacts

Paramètres de requête

Réponse

Supprimer un contact

Paramètres de chemin

Réponse