List SMTP Sink Credentials
List SMTP sink credentials used by apps to authenticate to the Email Testing SMTP sink.
List SMTP sink credentials used by apps to authenticate to the Email Testing SMTP sink.
These credentials don't send email. SMTP sink credentials belong to the Maileroo Sandbox (Email Testing Platform). Your app uses them to connect to the sandbox SMTP sink, which intercepts and captures test emails instead of delivering them. To send real email, use SMTP Relay or the Email API.
Scope: email_testing.credentials.read
Query Parameters
qstringoptionalOnly return credentials whose username contains this text (not case-sensitive). Up to 200 characters.
limitintegeroptionalHow many results to return per page. Defaults to 50, and at most 200 are returned.
cursorstringoptionalWhere to continue from. Pass the next_cursor value from the previous page; leave it out to start at the first page. An empty next_cursor means there are no more results.
Sample Request
curl "https://api.maileroo.com/v1/email-testing/smtp-credentials" \
-H "Authorization: Bearer roo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Sample Response
The response is wrapped in a data object.
{
"data": {
"credentials": [
{
"id": "19af8047-b6aa-4a0e-85aa-22bd4a734114",
"account_id": "12345",
"username": "a1b2c3d4e5f6",
"host": "smtp.sandbox.maileroo.io",
"port": 587,
"status": "active",
"created_at": "2025-01-01T12:00:00Z"
}
],
"next_cursor": ""
}
}Errors
400 Bad Request— invalid pagination or query parameters.