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.

POSThttps://g.sendcorex.com/v1command: get_contact
i

Les compteurs portent sur les 50 derniers e-mails dans chaque sens. capped: true signifie qu'il y en a davantage.

Arguments

  • emailstringobligatoire

    L'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

  • provider

    D'où vient son dernier e-mail, vérifié à la réception (voir Créer une règle). À défaut, une estimation à partir du domaine.

  • trust

    trusted, untrusted ou default.

  • unsubscribed

    Pré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.

  • 401TOKEN_EXPIRED

    L'access token a expiré. Appelez Refresh Token et relancez la requête.

  • 401INVALID_TOKEN

    Le token est mal formé, inconnu ou révoqué.

  • 429RATE_LIMITED

    Plus 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.

  • CMDINVALID_ARGS

    Un argument obligatoire est manquant ou invalide.

  • CMDINTERNAL

    Erreur serveur. Le détail est uniquement écrit dans le log du serveur.