Generate API keys
Generate a new Send Mail token (API key) for a specific Mail Agent.
Endpoint
post /mailagents/{mailagentkey}/apikeys
Copy full URL
Request URL
https://api.zeptomail.com/v1.1/mailagents/{mailagentkey}/apikeys Copied!
Scope
Zeptomail.MailAgents.CREATECopied!
(or)
Zeptomail.MailAgents.ALLCopied!
Request Parameters
- Path Parameters
mailagentkeystringMandatory
Unique key of the Mail Agent.
Sample Request
Curl
Java
Python
Deluge
Copied!
curl --request POST \
--url https://api.zeptomail.com/v1.1/mailagents/{mailagentkey}/apikeys \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Response Parameters
- HTTP code 200
Response Body - application/json
JSON Object
- HTTP code 400
Response Body - application/json
JSON Object
Possible Response Codes
200HTTP code
New API key (Send Mail token) generated successfully.
400HTTP code
Bad Request
Sample Response: HTTP 200
Copied!
{
"data": {
"created_time": "2025-06-12T11:50:00Z",
"id": "apikey-002",
"token": "Zoho-enczapikey yyyy"
},
"status": "success"
}
▼ Show full
Sample Response: HTTP 400
Copied!
{
"error": {
"code": "MA_107",
"message": "Mail agent name already exists"
},
"status": "failure"
}
▼ Show full
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.