--- updatedAt: 2026-08-26T10:06:08.000Z agentTools: projectIndex: https://docs.allegrow.co/llms.txt --- # List Safety Net Mailboxes Returns the mailboxes synced from your sales-engagement integrations (Outreach, Salesloft), with their Safety Net state. These are a different population from your connected mailboxes: the integration sync brings in every mailbox present in your sales-engagement platform, and `activated` reflects whether the Safety Net is switched on for each one. Many workspaces intentionally activate only a subset — use `activated=true` to list just the protected mailboxes. Results are sorted by `email` ascending and paginate with `limit`/`offset`. Returns the mailboxes synced from your sales-engagement integrations (Outreach, Salesloft), with their Safety Net state. These are a **different population** from your connected mailboxes ([List Connected Mailboxes](/reference/list-connected-mailboxes)): the integration sync brings in every mailbox present in your sales-engagement platform, whether or not it's connected to Allegrow. `activated` tells you whether the Safety Net is switched on for each one. Many workspaces intentionally activate only a subset of synced mailboxes — use `activated=true` to list just the protected ones (or `activated=false` for the rest). `total` reflects the filter. Safety Net state lives here, per mailbox — the [Users](/reference/list-users) endpoint deliberately carries no Safety Net data. # OpenAPI definition ```json { "openapi": "3.0.3", "info": { "title": "Allegrow Workspace API", "description": "The Allegrow Workspace API provides read-only, programmatic access to your workspace's connected mailboxes, sender reputation, sending domains, Safety Net mailboxes, and users — the same data shown in the Allegrow app, ready to plug into your own dashboards and BI tooling.\n", "version": "1.0.0", "contact": { "name": "Allegrow Support", "email": "support@allegrow.co" } }, "servers": [ { "url": "https://api.allegrow.co", "description": "Production API" } ], "security": [ { "ApiKeyAuth": [] } ], "paths": { "/v1/safety-net-mailboxes": { "get": { "summary": "List Safety Net Mailboxes", "description": "Returns the mailboxes synced from your sales-engagement integrations (Outreach, Salesloft), with their Safety Net state.\n\nThese are a different population from your connected mailboxes: the integration sync brings in every mailbox present in your sales-engagement platform, and `activated` reflects whether the Safety Net is switched on for each one. Many workspaces intentionally activate only a subset — use `activated=true` to list just the protected mailboxes.\n\nResults are sorted by `email` ascending and paginate with `limit`/`offset`.\n", "operationId": "listSafetyNetMailboxes", "tags": [ "Safety Net" ], "parameters": [ { "name": "activated", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "true", "false" ] }, "description": "Filter by the `activated` flag: `true` returns only Safety Net-activated mailboxes, `false` only non-activated ones. Omit to return all. `total` reflects the filtered count.", "example": "true" }, { "$ref": "#/components/parameters/LimitParam" }, { "$ref": "#/components/parameters/OffsetParam" } ], "responses": { "200": { "description": "Paginated list of integration mailboxes", "content": { "application/json": { "schema": { "type": "object", "required": [ "limit", "mailboxes", "offset", "total" ], "properties": { "limit": { "type": "integer", "example": 50 }, "mailboxes": { "type": "array", "items": { "$ref": "#/components/schemas/SafetyNetMailbox" } }, "offset": { "type": "integer", "example": 0 }, "total": { "type": "integer", "description": "Total number of matching integration mailboxes across all pages (after the `activated` filter, when supplied).", "example": 640 } } } } } }, "400": { "description": "Invalid query parameter", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SimpleError" }, "example": { "error": "activated must be true or false" } } } }, "401": { "$ref": "#/components/responses/MissingApiKeyError" }, "403": { "$ref": "#/components/responses/InvalidApiKeyError" }, "429": { "$ref": "#/components/responses/RateLimitError" }, "503": { "description": "A dependent Allegrow service is temporarily unavailable. Retry after the number of seconds in the `Retry-After` header.", "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Suggested seconds to wait before retrying." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SimpleError" }, "example": { "error": "Service temporarily unavailable" } } } } } } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "Your Allegrow API key" } }, "parameters": { "LimitParam": { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 50 }, "description": "Page size (1–1000). A single page can hold an entire workspace — for a full snapshot request limit=1000 rather than stitching offset pages, which are computed independently.", "example": 50 }, "OffsetParam": { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0 }, "description": "Zero-based index of the first entry to return.", "example": 0 } }, "responses": { "MissingApiKeyError": { "description": "Unauthorized - API key missing from the request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Unauthorized", "message": "Unauthorized", "statusCode": 401 } } } }, "InvalidApiKeyError": { "description": "Forbidden - API key invalid or inactive", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Forbidden", "message": "Forbidden", "statusCode": 403 } } } }, "RateLimitError": { "description": "Rate limit exceeded. Requests count against the same per-second rate limit as validation API calls.", "headers": { "Retry-After": { "description": "Suggested seconds to wait before retrying", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Too Many Requests", "message": "Too Many Requests", "statusCode": 429 } } } } }, "schemas": { "SafetyNetMailbox": { "type": "object", "required": [ "activated", "email", "id", "integrations" ], "properties": { "id": { "type": "string", "format": "uuid", "nullable": true, "description": "Opaque identifier for this integration mailbox — use it with GET /v1/safety-net-mailboxes/{id}. May briefly be `null` for a newly synced mailbox; refetch the list to obtain it.", "example": "550e8400-e29b-41d4-a716-446655440000" }, "activated": { "type": "boolean", "description": "Whether the Safety Net is switched on for this mailbox.", "example": true }, "email": { "type": "string", "format": "email", "example": "rep@allegrow.co" }, "integrations": { "type": "array", "description": "Sales-engagement integrations this mailbox was synced from.", "items": { "type": "string", "enum": [ "outreach", "salesloft" ] }, "example": [ "outreach" ] } } }, "Error": { "type": "object", "required": [ "message", "error", "statusCode" ], "properties": { "message": { "type": "string", "description": "Error message" }, "error": { "type": "string", "description": "Error type" }, "statusCode": { "type": "integer", "description": "HTTP status code" } } }, "SimpleError": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "string", "description": "Error message" } } } } } } ```