Descubrimiento

Una clave sin más basta para empezar. Dos llamadas la convierten en un contexto: qué organización abre, con qué rol y qué hay ya dentro.

Distinguir una clave de producción de una de prueba

Una clave no lleva ninguna etiqueta que diga a qué entorno pertenece. Lo que lleva es una organización, y eso es lo que hay que comprobar: compara organization.slug —o organization.id— con lo que espera tu integración, y detente si no coinciden.
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; }
Una llamada, al arrancar, y es toda la distancia entre un ensayo y una audiencia real. Un agente que se la salta descubre adónde apuntaba después del envío.

La secuencia de arranque

1

Averigua dónde estás

bash
curl -s -H "x-api-key: $AGENTMAIL_API_KEY" \
  "https://www.agentsmail.io/api/v1/me" | jq '.data'
Comprueba que la organización es la que querías y lee role: member significa que todas las escrituras de abajo responderán 403.
2

Elige la lista

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')
Una respuesta vacía significa que la organización todavía no tiene ninguna lista: crea una con POST /api/v1/lists, consulta Audiencia.
3

Trabaja la audiencia

bash
curl -s -H "x-api-key: $AGENTMAIL_API_KEY" \
  "https://www.agentsmail.io/api/v1/contacts?listId=$LIST_ID&status=subscribed"
Todo lo relativo a contactos y etiquetas —leer, añadir, importar un lote, dar de baja— está en Audiencia. GET /api/v1/tags es el mismo truco que /lists, para los id de etiqueta.
4

Compón y envía

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"
Las plantillas, el renderizado, las campañas y el propio envío están en Contenido y envío, que recorre todo el camino de principio a fin.
Dos llamadas de contexto, y el resto de la API responde. Aquí no se guarda nada de tu lado: un agente que empieza cada ejecución con /me y /lists nunca trabaja con un id obsoleto.