Reports: FAQs & Troubleshooting
View the frequently asked questions related to Email reports.
Live Feed
How do I export activity from my Netcore Email API account?
To export your data, navigate to Live Feeds and click the Download button. You can then select the specific timeframe and filters for the activity report you wish to generate.
How can I search for specific email activity?
In the Live Feeds section, you can search for activity using the following criteria:
- Sender’s Email Address: Filter by the address used to send the email.
- Recipient’s Email Address: Search for all activity associated with a specific recipient.
What do the different email statuses mean?
Understanding your delivery metrics is key to optimizing your campaigns. Here is a breakdown of what each status signifies:
| Status | Definition |
|---|---|
| Sent | The message has reached Netcore servers and is being relayed to the recipient's server (e.g., Gmail, Outlook). We are currently awaiting a delivery confirmation. |
| Delivered | The recipient's server has successfully accepted the email. Note: This confirms delivery to the server, not necessarily the Inbox (it could still land in the Spam/Junk folder). |
| Opened | The recipient has opened the email. This requires Open Tracking to be enabled in your settings. |
| Clicked | The recipient clicked at least one link within the email (excluding the "Unsubscribe" link). |
| Unsubscribed | The recipient clicked your unsubscribe link to opt-out of future communications. |
| Spam | The recipient manually flagged your email as "Spam." This is a direct complaint and differs from an ISP automatically filtering an email into a junk folder. |
| Bounced | The email could not be delivered. (See "Types of Bounces" below). |
| Dropped | The email was blocked by Netcore because the recipient’s address is on a Suppression List (due to previous bounces or unsubscribes). |
Why are my emails in a "Processed" state?
If your emails remain in a "Processed" state without moving to "Sent," it is usually due to one of the following reasons:
- Exhausted Credits: Your account has run out of email credits.
- Account Disabled: Your account may have been suspended or disabled.
- Throttling: The recipient's server is temporarily refusing new requests from the sending server to prevent overloading.
What is the difference between a Soft Bounce and a Hard Bounce?
- Soft Bounce: A temporary delivery failure (e.g., the recipient’s inbox is full or there is a connection timeout). Netcore will automatically retry delivery for up to 5 days.
- Hard Bounce: A permanent delivery failure (e.g., the email address is invalid or the destination server does not exist). Netcore automatically blocks these addresses to protect your sender reputation.
What does the "Remarks" column signify in Live Feeds?
The Remarks column displays the raw acknowledgment message or "handshake" received from the recipient's mail server. This is helpful for troubleshooting specific delivery failures or delays.
How do I enable tracking for Opens and Clicks?
By default, tracking is enabled. If you need to adjust these settings:
- Go to the Netcore Email API Panel.
- Navigate to Settings > Customize.
- Toggle Open Tracking or Click Tracking as needed.
Pro-Tip: To customize your Unsubscribe page, navigate to Settings > Customize > Customize Unsubscribe Page/Link.
Would you like me to help you draft a troubleshooting guide for improving your "Delivered to Inbox" rates?
Data Privacy & Retention
Can I view the content of my emails in reports?
No. To ensure the highest level of privacy and security for both senders and recipients, Netcore Email API does not store the body or content of your emails. Our reports focus strictly on delivery metrics and metadata.
How long does Netcore Email API retain my data?
We store your email activity data and logs for a period of 90 days. We recommend exporting any critical data regularly if you require long-term record-keeping.
Organizing with Tags
How do I use Tags in Netcore Email API?
Tags allow you to categorize your emails (e.g., by campaign type or purpose) to easily search activity and compare performance statistics.
Common examples include:
Invoice_EmailsOTP_VerificationMonthly_Newsletter
How to implement Tags (SMTP & API)
You can assign tags to your emails during the sending process. For SMTP users, simply add a custom header to your message:
Header Format:
X-TAGS: "Tag Name"
Multiple Tags:
You can assign multiple, comma-separated tags to a single email:
X-TAGS: "Movie Tickets, Invoice Emails"
Note: The
X-TAGSheader is used for internal tracking only. Netcore automatically strips this header before the email reaches the recipient, so it remains invisible to your customers.
What are custom tracking parameters (X-APIHEADER)?
The X-APIHEADER is a custom handling instruction that allows you to pass unique transaction identifiers—such as an Invoice ID or Transaction ID—through our SMTP.
How do I send and use custom parameters?
By including the X-APIHEADER in your email metadata, you link specific internal data to a specific email transaction.
- Format: The value can be passed in any string format (e.g.,
X-APIHEADER: 282747328). - Storage: We store this value as plain text and link it to the specific SMTP transaction in your account.
- Webhooks: If you use Webhooks, Netcore will return this exact value in the payload, allowing you to automatically sync email events (like opens or bounces) with your internal database records.
Updated about 2 months ago
