DeletePOP3

Delete an individual POP3 user name from the database.

Usage

Use this command to delete an individual POP3 email user name. Once you delete it, you can fill that vacancy with another name. This command has no effect on the POP 10-pak nor on any other user names in the account.

Availability

All resellers have access to this command.

Implementation on eNom.com

This command is not implemented on enom.com.

Constraints

The query must meet the following requirements:

  • The login ID and password must be valid.
  • The domain name must belong to this account.
  • The user name must be listed in the POP3 list for the account.
  • The user name must be in a POP pak for which the subscription is current.

Input Parameters

Build the query string using this syntax:

https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
&paramname=paramvalue&nextparamname=nextparamvalue
Input ParameterStatusDescriptionMax Size
UIDRequiredAccount login ID20
PWRequiredAccount password20
SLDRequiredSecond-level domain name (for example, enom in enom.com) for the domain this service is associated with63
TLDRequiredTop-level domain name (extension) for the domain this service is associated with15
UserNameXRequiredPOP mailbox user name to delete. Start with UserName1 and index to delete multiple user names, for example, UserName1=John.Doe&UserName2=Jane.Doe16
ResponseTypeOptional Format of response.Permitted values are Text (default), HTML, or XML.4

Returned Parameters and Values

Output ParameterDescription
CommandName of command executed
ErrCountThe number of errors if any occurred. If greater than 0 check the Err(1 to ErrCount) values.
ErrXError messages explaining the failure. These can be presented as is back to the client.
DoneTrue indicates this entire response has reached you successfully.

Notes

  • The default response format is plain text. To receive the response in HTML or XML format, sendResponseType=HTML or ResponseType=XML in your request.
  • Check the return parameter ErrCount. If greater than 0 the transaction failed. The parameterErr(ErrCount) can be presented to the client. Otherwise process the returned parameters as defined above.

Example

The following query deletes the POP user james and sends the response in XML, HTML, or Text format.

https://resellertest.enom.com/interface.asp?
command=DeletePOP3&uid=resellid&pw=resellpw&sld=resellerdocs
&tld=com&UserName1=james&responsetype=xml
https://resellertest.enom.com/interface.asp?
command=DeletePOP3&uid=resellid&pw=resellpw&sld=resellerdocs
&tld=com&UserName1=james&responsetype=html
https://resellertest.enom.com/interface.asp?
command=DeletePOP3&uid=resellid&pw=resellpw&sld=resellerdocs
&tld=com&UserName1=james&responsetype=text

The response is as follows:

<interface-response>
 <AccountsDeleted>1</AccountsDeleted>
 <success>True</success>
 <Command>DELETEPOP3</Command>
 <Language>eng</Language>
 <ErrCount>0</ErrCount>
 <ResponseCount>0</ResponseCount>
 <MinPeriod>1</MinPeriod>
 <MaxPeriod>10</MaxPeriod>
 <Server>sjl21wresellt01</Server>
 <Site>eNom</Site>
 <IsLockable>True</IsLockable>
 <IsRealTimeTLD>True</IsRealTimeTLD>
 <TimeDifference>+8.00</TimeDifference>
 <ExecTime>0.219</ExecTime>
 <Done>true</Done>
 <debug/>
 <TrackingKey>ef0e27fe-c956-4f45-a1f9-da8b6b8adea5</TrackingKey>
 <RequestDateTime>12/12/2011 3:17:09 AM</RequestDateTime>
</interface-response>
;URL Interface
;Machine is SJL0VWRESELL_T1
;Encoding Type is utf-8
success: True
Command: DELETEPOP3
APIType: API.NET
Language: eng
ErrCount: 0
ResponseCount: 0
MinPeriod: 1
MaxPeriod: 10
Server: sjl0vwresell_t1
Site: eNom
IsLockable:
IsRealTimeTLD:
TimeDifference: +0.00
ExecTime: 0.594
Done: true
TrackingKey: fbed2f7d-f570-4a55-82dd-f327f31684fe
RequestDateTime: 2/11/2015 1:03:15 PM
;URL Interface
;Machine is SJL0VWRESELL_T1
;Encoding Type is utf-8
success: True
Command: DELETEPOP3
APIType: API.NET
Language: eng
ErrCount: 0
ResponseCount: 0
MinPeriod: 1
MaxPeriod: 10
Server: sjl0vwresell_t1
Site: eNom
IsLockable:
IsRealTimeTLD:
TimeDifference: +0.00
ExecTime: 0.594
Done: true
TrackingKey: fbed2f7d-f570-4a55-82dd-f327f31684fe
RequestDateTime: 2/11/2015 1:03:15 PM

Related Commands

DeleteAllPOPPaks
DeletePOPPak
Forwarding
GetCatchAll
GetForwarding
GetMailHosts
GetPOP3
ModifyPOP3
PurchasePOPBundle
SetCatchAll
SetUpPOP3User