Create an Application
Create a new application with SMTP credentials and a sending key.
Create a new application. Applications provide their own SMTP credentials and sending key, and can be scoped to specific domains and IP allowlists.
Scope: applications.write
Request Body
namestringrequiredApplication name (1–191 characters).
authorized_domainsinteger[]optionalDomain IDs the application is authorized to send from.
ip_allowliststring[]optionalAllowed IP addresses or CIDR blocks.
local_part_liststring[]optionalAllowed local parts for the From address; an empty list is unrestricted. Maximum 64 entries; values are lowercased and trimmed, and must be 1–64 characters matching ^[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?$.
allowed_recipient_domainsstring[]optionalAllowed recipient domains; an empty list is unrestricted. Maximum 64 entries; values are lowercased with trailing dots removed, and must be full domains such as gmail.com, up to 128 characters.
outbound_ipsinteger[]optionalOutbound IP allotment IDs.
notesstringoptionalOptional notes (maximum 512 characters).
Sample Request
POST https://api.maileroo.com/v1/applications
Content-Type: application/json
{
"name": "My App",
"authorized_domains": [123],
"ip_allowlist": ["203.0.113.0/24"],
"local_part_list": ["hello", "noreply"],
"allowed_recipient_domains": ["gmail.com", "example.org"],
"outbound_ips": [],
"notes": ""
}Sample Response
Returns 201 Created with the full application detail (same shape as Get an Application).