Create Inbound Route
Create an inbound route for a domain.
Create an inbound route for a domain.
Scope: domains.inbound_routing.write
Path Parameters
domain_idintegerrequiredThe ID of the domain.
Request Body
The writable subset of the route object:
descriptionstringrequired3-255 characters.
expression_typestringrequiredOne of catch_all, custom, match_header, match_recipient.
header_namestringoptionalRequired when expression_type=match_header.
header_contentstringoptionalRequired when expression_type=match_header.
recipientstringoptionalRequired when expression_type=match_recipient.
custom_expressionstringoptionalRequired when expression_type=custom (expression syntax).
regex_enabledbooleanoptionalTreat expression content as regex.
forward_liststring[]requiredNon-empty list of email addresses and/or callback URLs.
dmarc_alignmentbooleanoptionalRequire DMARC alignment.
require_spfbooleanoptionalRequire SPF pass.
require_dkimbooleanoptionalRequire DKIM pass.
skip_spam_checkbooleanoptionalSkip spam filtering.
stopbooleanoptionalStop processing further routes when matched.
priorityintegerrequired1 (highest) to 100 (lowest).
Sample Request
POST https://api.maileroo.com/v1/domains/123/inbound-routes
Content-Type: application/json
{
"description": "Support inbox",
"expression_type": "match_recipient",
"recipient": "[email protected]",
"forward_list": ["[email protected]", "https://example.com/inbound-hook"],
"require_spf": true,
"stop": true,
"priority": 10
}Sample Response
Returns 201 Created with the created route object.
Note: The upstream create response does not include the new route, so it is located and returned by matching the submitted fields.