Découverte

Une clé nue suffit pour commencer. Deux appels la transforment en contexte : quelle organisation elle ouvre, avec quel rôle, et ce qui s'y trouve déjà.

Distinguer une clé de production d'une clé de test

Une clé ne porte aucune étiquette indiquant l'environnement auquel elle appartient. Ce qu'elle porte, c'est une organisation, et c'est cela qu'il faut vérifier : comparez organization.slug — ou organization.id — à ce qu'attend votre intégration, et arrêtez-vous s'ils diffèrent.
bash
ORG=$(curl -s -H "x-api-key: $AGENTMAIL_API_KEY" \
  "https://www.agentsmail.io/api/v1/me" | jq -r '.data.organization.slug')

[ "$ORG" = "acme-staging" ] || { echo "wrong organization: $ORG"; exit 1; }
Un appel, au démarrage, et c'est toute la distance entre une répétition et une vraie audience. Un agent qui l'omet découvre où il était pointé après l'envoi.

La séquence d'amorçage

1

Savoir où vous êtes

bash
curl -s -H "x-api-key: $AGENTMAIL_API_KEY" \
  "https://www.agentsmail.io/api/v1/me" | jq '.data'
Vérifiez que l'organisation est bien celle que vous visiez, et lisez role : member signifie que chaque écriture ci-dessous répondra 403.
2

Choisir la liste

bash
LIST_ID=$(curl -s -H "x-api-key: $AGENTMAIL_API_KEY" \
  "https://www.agentsmail.io/api/v1/lists" | jq -r '.data[] | select(.name == "Newsletter") | .id')
Une réponse vide signifie que l'organisation n'a encore aucune liste — créez-en une avec POST /api/v1/lists, voir Audience.
3

Travailler l'audience

bash
curl -s -H "x-api-key: $AGENTMAIL_API_KEY" \
  "https://www.agentsmail.io/api/v1/contacts?listId=$LIST_ID&status=subscribed"
Tout ce qui concerne les contacts et les tags — lire, ajouter, importer un lot, désabonner — se trouve dans Audience. GET /api/v1/tags suit la même logique que /lists, pour les identifiants de tags.
4

Composer et envoyer

bash
curl -s -X POST -H "x-api-key: $AGENTMAIL_API_KEY" -H "content-type: application/json" \
  -d '{"name":"August newsletter","subject":"What shipped in August","templateId":"'$TEMPLATE_ID'","listId":"'$LIST_ID'"}' \
  "https://www.agentsmail.io/api/v1/campaigns"
Les modèles, le rendu, les campagnes et l'envoi lui-même se trouvent dans Contenu et envoi, qui parcourt tout le chemin de bout en bout.
Deux appels de contexte, et le reste de l'API répond. Rien n'est stocké de votre côté : un agent qui commence chaque exécution par /me et /lists ne travaille jamais avec un identifiant périmé.