Skip to content
Hissline

APIAdresses email pour agents

API email pour les agents IA,
conçue pour le multicanal.

Des boîtes en entrée, des événements structurés en sortie.

Offre gratuite, environ 50 requêtes par jour. Sans carte. Le JSON entrant se consulte en polling sur l'offre gratuite.

Offre gratuite~50 requêtes/jour, sans carte
Signé HMACDes webhooks que vous pouvez vérifier
Spec OpenAPITypée. Générez n'importe quel client.
Domainestail.me maintenant, votre domaine ensuite
POST /email_addresses

Un appel ouvre une adresse. Le mail revient en JSON.

Pas de boîte à scraper. Créez l'adresse, puis interrogez-la ou pointez un webhook dessus.

  • Créez une adresse aléatoire, une partie locale choisie, ou un lot.
  • Le mail entrant arrive en JSON : expéditeur, objet, corps, pièces jointes.
  • Interrogez la liste entrante sur tous les plans. Ajoutez un webhook signé dès Pro.
  • Envoyez en sortie depuis cette adresse dès Business. Apportez votre domaine sur les plans supérieurs.
curl -X POST https://app.mailhook.co/api/v1/email_addresses/random \
  -H "X-Agent-ID: $AGENT_ID" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain_id":"dom_…"}'
# X-Webhook-Signature: HMAC-SHA256 of the raw body
{
  "event": "inbound_email",
  "data": {
    "email_address": "[email protected]",
    "from": "[email protected]",
    "subject": "Your verification code",
    "text_body": "Your code is 482913."
  }
}
curl -X POST https://app.mailhook.co/api/v1/outbound_emails \
  -H "X-Agent-ID: $AGENT_ID" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email_address_id":"ea_…","to":"[email protected]","subject":"Received","text_body":"Got it."}'
Comment ça marche

Trois stations sur une ligne.

01 · Provision

Ouvrir une adresse

Un appel API donne à un agent sa propre adresse, sur un domaine tail.me ou le vôtre.

POST /email_addresses
02 · Parse

Transformer le mail en JSON

Les messages entrants sont parsés : expéditeur, objet, corps et pièces jointes.

inbound_email
03 · Livraison

Vers votre agent

Interrogez la liste entrante, ou recevez un webhook signé. Répondez en sortie si votre plan le permet.

webhook · poll
Ce qui existe

Mail entrant. JSON sortant. Réponse.

Des adresses pour les agents, l'entrant en JSON, la sortie depuis la même adresse, et les domaines que vous possédez déjà.

En ligne

Email entrant

Une adresse par agent. Expéditeur, objet, corps et pièces jointes, parsés.

Webhooks

Du JSON signé à l'arrivée d'un message, dès Pro. Tous les plans peuvent interroger l'API.

Sortie

Envoyez depuis l'adresse de l'agent via l'API, dès Business.

Domaines personnalisés

Une adresse tail.me sur tous les plans. Votre domaine sur les plans supérieurs.

Sécurité

Livraisons signées. Une clé à chaque appel.

HMAC sur chaque webhook

SHA-256 sur le corps brut, dans l'en-tête X-Webhook-Signature. Recalculez-le et rejetez ce qui ne correspond pas.

OpenSSL::HMAC.hexdigest("SHA256", secret, raw_body)
# header: X-Webhook-Signature

Privé, lié à votre clé API

Chaque appel envoie X-Agent-ID et X-API-Key. Une adresse n'est pas une boîte publique.

-H "X-API-Key: …"

Mettez votre premier agent
sur la ligne.

Offre gratuite, environ 50 requêtes par jour. Créez une adresse en un appel API.

curl
curl -X POST $API/email_addresses/random \
  -H "X-Agent-ID: $AGENT_ID" \
  -H "X-API-Key: $API_KEY" \
  -d '{"domain_id":"dom_…"}'