Skip to content

Docs / All tools / Loop II: Acquisition

outbound.mail.sender_add

Add a sender address on your own domain and get the required DNS records.

0 credits. Free: setup.

Example prompt

Send this to your AI app when Heelo is connected:

Add [email protected] as the default sender of my domain, with the From name Sam at Example, and forward the replies to [email protected].

Input fields

FieldTypeDescription
from_emailRequiredstringThe From address to send from, for example [email protected]. The user must control the DNS of its domain: the answer gives the DNS records to publish there.
forward_toRequiredstringThe user's mailbox that replies to this sender are forwarded to. Ask the user for it and never make one up: replies are forwarded only after its owner confirms it.
from_namestringThe display name shown with the address, on one line.
is_defaultbooleanMake this the default sender of its domain, which tools that only name a domain use.

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.sender_add/invoke",
    headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
    json={"input": {
        "from_email": "[email protected]",
        "forward_to": "[email protected]",
    }},
    timeout=120,
)
response.raise_for_status()
print(response.json())