Skip to content

Docs / All tools / Loop II: Acquisition

outbound.mail.suppress_check

Check whether an email address is on the suppression list.

0 credits. Free: compliance step.

Example prompt

Send this to your AI app when Heelo is connected:

Is [email protected] on my do-not-mail list?

Input fields

FieldTypeDescription
emailRequiredstringThe recipient's email address.

Code

The call with the input fields that the tool needs. Set HEELO_API_KEY to your API key.

import os
import requests

response = requests.post(
    "https://toolsprimitives.uk/v1/tools/outbound.mail.suppress_check/invoke",
    headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
    json={"input": {
        "email": "[email protected]",
    }},
    timeout=120,
)
response.raise_for_status()
print(response.json())