Getting Started
1. How do I get access to the Email API?
To get access to the Email API, please get in touch with your Account Manager or Customer Success Manager. They will help you enable Email API access on your account.
2. What do I need to start using the Email API?
You will need the following:
->A valid Vonage API key
->A sending domain that you own and have access to configure DNS records for
->Optionally, a Vonage Application to configure webhook settings for delivery status
callbacks
3. What is the current phase of the Email API?
The Email API is currently in Open Beta and is available to all Managed Customers of Vonage.
Domain Verification & Onboarding
4. What steps do I need to take to verify my domain?
Once you provide the required information, you will be given a set of DNS records. You need to configure these records in your domain provider's DNS settings. Make sure you add these records as soon as possible; verification must be completed within 72 hours. If there is a delay, please ask for help from your AM. Once the records are updated, your domain will be verified automatically, and you can start using the Email API.
5. Which region can I choose to verify my domain?
You can choose one of three regions: APAC, EU, or US. Only one region can be selected per domain verification.
6. Can I request a custom "Mail From" address with Vonage?
Yes. Please provide your preferred keyword or subdomain to be used as the custom "Mail From" option during onboarding.
7. Is there a self-service option on the Customer Dashboard to verify my domain?
Not yet. Self-service domain verification via the Customer Dashboard is planned for Q3 2026. Currently, you need to contact your Account Manager or Customer Success Manager to complete onboarding.
Features & Capabilities
8. Can I get a dedicated IP address during the Beta phase?
No. Dedicated IP addresses are not available during the Beta phase. They will be available from end of Q3 2026 onwards, and will be included free of charge with Advanced plans at General Availability (GA). Additionally Vonage will use shared IP Pool to send your emails to users.
9. How does Vonage manage domain and IP reputation?
Vonage ensures that each customer's domain reputation is isolated. One domain's reputation does not affect another. In addition, Vonage manages a suppression list for your domain to protect your sender reputation.
10. What is a suppression list?
A suppression list is a feature that is enabled by default for your domain. It automatically adds recipients to a block list if they generate a hard bounce or mark your email as spam, preventing further emails from being sent to those addresses. This protects your domain's sender reputation.
11. Does Vonage support CC and BCC?
CC and BCC support is planned for Q3 2026.
12. Does Vonage support attachments and unsubscribe features?
Not yet. Both attachment support and unsubscribe management are planned for the end of 2026.
13. What is the maximum email size I can send via the Vonage Email API?
The maximum email body size is 100 KB. Attachments are not currently supported, so this limit applies to the email body only.
14. Can I send an email to multiple recipients?
Currently, only a single recipient is supported in the To field per API request. CC and BCC support is coming in Q3 2026.
15. Can I receive inbound emails on my domain?
Not yet. Inbound email support is planned for end of Q3 2026
Delivery Status & Reporting
16. How do I get the status of my sent emails?
There are multiple ways to track the status of your sent emails:
Webhooks: Configure a status webhook URL in your Vonage Application (for JWT authentication) or in your account-level Dashboard settings (for Basic authentication) or in your API request to receive real-time delivery status callbacks.
Customer Dashboard: View message logs and basic analytics under Logs →Messages API in the Customer Dashboard.
Reports API: Download CDR (Call Detail Record) reports for your email traffic via the Reports API under the email channel.
17. What delivery status events can I expect?
The Email API uses the same status values as other Messages API channels for consistency:
| Status | Description |
| submitted | The API has accepted the message |
| delivered | The recipient's mail server accepted the message |
| read | The recipient opened the email |
| rejected | The message could not be delivered (check the error code for details) |
Omnichannel & Integration
18. Can I use the Email API with other channels as a failover or bundling strategy?
Yes. You can use the email channel alongside other channels in the Messages API as part of a failover or bundling strategy. For example, you can configure a workflow to send a WhatsApp message first and automatically fall back to email if the message is not delivered.
Pricing & Billing
19. How does Email API billing work?
The Email API is charged on a subscription basis. Plans are available from $50/month for 100,000 emails up to $750/month for 2,500,000 emails, with custom Enterprise pricing available. Please contact your Account Manager for more details or to select a plan.
20. Can I get free emails to test the API?
Yes. All new accounts receive 3,000 free emails, valid for up to two calendar months from the date of activation.
Support & Resources
21. Who do I contact if I have a technical issue?
For onboarding and Email API setup queries, contact your Account Manager or Customer Success Manager.
For technical API issues, raise a support ticket via the standard support process. Issues will be routed to the Messages API Support team.
22. Where can I find the developer documentation?
The public developer documentation is available at developer.vonage.com.