Recevoir des e-mails : Contact et relance
Obtenir un contact
Qui est cette personne dans votre boîte aux lettres : conversations, confiance, votre note, désabonnements, relances, les règles qui l'interceptent et le fournisseur depuis lequel elle envoie.
https://g.sendcorex.com/v1command: get_contactLes compteurs portent sur les 50 derniers e-mails dans chaque sens. capped: true signifie qu'il y en a davantage.
Arguments
emailstringobligatoireL'adresse du contact.
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "get_contact",
args: {
email: "ana@client.com"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Réponse
{
"type": "SUCCESS",
"results": [
{
"command": "get_contact",
"id": "0",
"type": "SUCCESS",
"data": {
"email": "ana@client.com",
"name": "Ana Costa",
"domain": "client.com",
"provider": "microsoft_365",
"free_email": false,
"received": 18,
"sent": 11,
"conversations": 9,
"capped": false,
"first_at": "2026-03-02T02:10:00Z",
"last_at": "2026-10-24T03:10:00Z",
"recent": [
{
"thread_id": "thr_9a1c4e72",
"subject": "Proposal",
"date": "2026-10-24T03:10:00Z",
"from_them": true,
"unread": false
}
],
"trust": "trusted",
"note": "VIP, prefers WhatsApp",
"followups": [
{
"thread_id": "thr_9a1c4e72",
"message_uid": "Vj0xQUJDMTIz",
"status": "pending",
"remind_at": "2026-10-29T01:00:00Z",
"sent_at": "2026-10-26T01:00:00Z",
"subject": "Proposal",
"to_email": "ana@client.com",
"created_at": "2026-10-26T01:00:00Z"
}
],
"matching_rules": [
{
"id": "Vj0xUlVMRTAx",
"name": "Clients always in Inbox"
}
]
}
}
]
}Champs de la réponse
providerD'où vient son dernier e-mail, vérifié à la réception (voir Créer une règle). À défaut, une estimation à partir du domaine.
trusttrusted,untrustedoudefault.unsubscribedPrésent quand vous vous êtes désabonné de sa liste.
Erreurs
Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.
- 401
TOKEN_EXPIREDL'access token a expiré. Appelez Refresh Token et relancez la requête.
- 401
INVALID_TOKENLe token est mal formé, inconnu ou révoqué.
- 429
RATE_LIMITEDPlus de 15 requêtes/s ou 15 en cours pour la même IP + boîte aux lettres. Attendez le nombre de secondes indiqué dans Retry-After.
- CMD
INVALID_ARGSUn argument obligatoire est manquant ou invalide.
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.