Logs and troubleshooting

For resource setup problems, inspect the Management API resource status and validation errors.
For email sent from an existing Delivery account, use Send API IDs with Delivery TraceMail.
For hosted mailbox traffic, use Email log analysis.

IDs to keep

When using the Send API, first make sure the message was sent with a token from the correct Delivery account. Then always store:

Field	Why it matters
`request_id`	Correlates one API request across logs and support investigations.
`message_id`	Identifies the queued message and helps trace delivery events.
recipient email	Helps search TraceMail and suppression-list results.
your own order/user/campaign ID	Helps reconcile API events with your application.

Use Delivery TraceMail endpoints in the Management API to inspect Delivery sending activity.

TraceMail can help answer questions such as:

Useful areas in the reference include:

Use Email log analysis endpoints to inspect hosted email logs:

Email log analysis is for Hosting mailbox traffic. Delivery TraceMail is for Delivery sending traffic.

Check the HTTP status.
Check the error code and message.
Confirm the Delivery account exists and is the right sender for this integration.
Confirm the bearer token belongs to that Delivery account.
Confirm the sending domain is configured for the account.
Confirm the client IP is allowed by token and account allow-lists.
Confirm the account is enabled and has quota.
Confirm the payload respects size and batch limits.

Confirm the request returned 202 Accepted.
Store and search by request_id and message_id.
Check account/domain assignment and DNS verification.
Check suppression-list behavior.
Check Delivery account status and quota.
If the issue persists, contact support with request_id, message_id, timestamp, sender, and recipient.

Check the resource status and status_detail.
Confirm ownership and DNS checks.
Confirm the authenticated user has access to the resource.
For mailbox traffic, inspect Email log analysis access, incoming, and outgoing logs.

Some operational endpoints exist for Qboxmail staff to inspect and retry failed queue jobs. They are not intended for customer integrations.

For customer integrations, use Send API responses, Delivery TraceMail, resource status, and support when needed.