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
| Field | Type | Description |
|---|---|---|
from_emailRequired | string | The 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_toRequired | string | The 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_name | string | The display name shown with the address, on one line. |
is_default | boolean | Make 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())// Node.js 18 or newer, in an ES module.
const response = await fetch("https://toolsprimitives.uk/v1/tools/outbound.mail.sender_add/invoke", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HEELO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
input: {
"from_email": "[email protected]",
"forward_to": "[email protected]"
},
}),
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());