Update Sender Profile
Update a sender profile's name, enabled channels, or rate limit.
Update one or more fields on a sender profile. Fields omitted from the request are unchanged.
Scope: verify.sender_profiles.write
Path Parameters
idstringrequiredSender profile ID with the prf_ prefix.
Request Body
namestringoptionalNew profile name from 1 to 80 characters.
enabled_channelsstring[]optionalReplacement list containing one or more of sms, voice, whatsapp, telegram, and email.
rate_limitobject or nulloptionalSet the limit with max from 1 to 10,000, window_seconds from 1 to 2,592,000, and optional scope (destination or profile). Send null to remove the limit. Omitted scope defaults to destination.
Sample Request
Request
curl -X PATCH "https://api.maileroo.com/v1/verify/sender-profiles/prf_0123456789abcdef01234567" \
-H "Authorization: Bearer roo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"name":"Acme sign-in","rate_limit":null}'Sample Response
Returns 200 OK.
Response
{
"data": {
"id": "prf_0123456789abcdef01234567",
"name": "Acme sign-in",
"enabled_channels": ["sms", "voice"],
"created_at": "2025-01-01T12:00:00Z",
"updated_at": "2025-01-02T09: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.404 Not Found— the sender profile does not exist for this account.