{"uid":"cap_WrDVSVBifVdJBOvYwGOZC","slug":"agentmail-metrics-cecddeab","name":"AgentMail Inbox Metrics Query","description":"Query Metrics","url":"https://mpp.api.agentmail.to/v0/inboxes/:inbox_id/metrics?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["inbox_id"],"properties":{"end":{"type":"string","title":"End","format":"date-time","description":"End timestamp for the query."},"limit":{"type":"integer","title":"MetricLimit","description":"Limit on number of buckets to return."},"start":{"type":"string","title":"Start","format":"date-time","description":"Start timestamp for the query."},"period":{"type":"string","title":"Period","description":"Period in number of seconds for the query."},"inbox_id":{"type":"string","title":"InboxId","description":"The ID of the inbox."},"descending":{"type":"boolean","title":"Descending","description":"Sort in descending order."},"event_types":{"type":"array","items":{"enum":["message.sent","message.delivered","message.bounced","message.delayed","message.rejected","message.complained","message.received"],"type":"string","title":"MetricEventType","description":"Type of metric event."},"title":"MetricEventTypes","description":"List of metric event types to query."}}},"responseSchema":{"type":"object","title":"QueryMetricsResponse","description":"Metrics grouped by event type.","additionalProperties":{"type":"array","items":{"type":"object","title":"MetricBucket","required":["timestamp","count"],"properties":{"count":{"type":"integer","description":"Count of events in the bucket."},"timestamp":{"type":"string","format":"date-time","description":"Timestamp of the bucket."}}}}},"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unprobed","priceSource":"unknown","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Query time-series metrics for email events (sent, delivered, bounced, etc.) on a specific AgentMail inbox, grouped into configurable time buckets.","exampleAgentPrompt":"Show me the email delivery metrics for AgentMail inbox 'inbox_abc123' from January 1st to January 31st, broken into daily buckets, for message.sent and message.bounced events.","exampleUseCases":null,"resultDescription":"Returns an object keyed by event type (e.g. 'message.sent', 'message.bounced'), each mapping to an array of time-bucketed objects containing a timestamp and count of events in that bucket.","failureModes":["Invalid inbox_id returns 404 not found","Missing or invalid Authorization header returns 401 unauthorized","Invalid date-time format for start/end returns 422 validation error","Invalid event_type enum value returns 422 validation error","Period value not a valid integer string returns 422 validation error","No data in range returns empty arrays per event type"],"whenToPreferThis":"Use this endpoint when you need time-series analytics on email activity for a specific AgentMail inbox — ideal for monitoring delivery health, detecting bounce spikes, or auditing message volume over a custom time window. Prefer this over general inbox listing endpoints when the goal is aggregated counts and trends rather than individual message details.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:51:58.566Z","isFirstParty":false,"canonicalSlug":"agentmail-metrics-cecddeab"}