Create Sender Profile
Create a sender profile with enabled channels and an optional rate limit.
Create a sender profile for verification requests.
Scope: verify.sender_profiles.write
Request Body
namestringrequiredProfile name from 1 to 80 characters.
enabled_channelsstring[]requiredOne or more of sms, voice, whatsapp, telegram, and email.
rate_limitobjectoptionalOptional object with max from 1 to 10,000, window_seconds from 1 to 2,592,000, and scope set to destination or profile. Omitted scope defaults to destination.
Sample Request
Request
curl -X POST "https://api.maileroo.com/v1/verify/sender-profiles" \
-H "Authorization: Bearer roo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"name":"Acme login","enabled_channels":["sms","voice"],"rate_limit":{"max":5,"window_seconds":60,"scope":"destination"}}'Sample Response
Returns 201 Created.
Response
{
"data": {
"id": "prf_0123456789abcdef01234567",
"name": "Acme login",
"enabled_channels": ["sms", "voice"],
"rate_limit": {
"max": 5,
"window_seconds": 60,
"scope": "destination"
},
"created_at": "2025-01-01T12:00:00Z",
"updated_at": "2025-01-01T12:00:00Z"
}
}Errors
Common authentication, rate-limit, and service-availability errors are described in the Introduction. This endpoint can also return:
400 Bad Request— invalid JSON, name, channel list, or rate-limit values.