UAPI accesses the cPanel interface's features. Use this API to access and modify cPanel account data and settings.
Download OpenAPI description
Overview
URL
WebPros International, LLC
License
Languages
Servers
Mock server
https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/
A server running cPanel.
https://{host}:{port}/execute/
Request
This function changes an email account's password.
Important:
When you disable the Receive Mail role, the system disables this function.
Security
BasicAuth
- Mock server
https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/Email/passwd_pop
- A server running cPanel.
https://cpanel-server.tld:2083/execute/Email/passwd_pop
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
'https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/Email/passwd_pop?email=username%40example.com&password=12345luggage&domain=example.com'Response
application/json
{ "apiversion": 3, "func": "passwd_pop", "module": "Email", "result": { "data": null, "errors": null, "messages": null, "metadata": {}, "status": 1, "warnings": null } }
- Mock server
https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/Email/release_outgoing
- A server running cPanel.
https://cpanel-server.tld:2083/execute/Email/release_outgoing
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
'https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/Email/release_outgoing?email=username%40example.com'Response
application/json
{ "apiversion": 3, "func": "release_outgoing", "module": "Email", "result": { "data": null, "errors": null, "messages": null, "metadata": {}, "status": 1, "warnings": null } }
Request
This function configures a default (catchall) email address.
Important:
When you disable the Mail Receive role, the system disables this function.
Security
BasicAuth
Query
The method to use to handle unroutable mail.
fwd— Forward messages to thefwdemailparameter’s address.fail— Bounce messages back to the sender, and include thefailmsgsparameter’s failure message.blackhole— Send messages to the/dev/null/directory. This method does not generate a failure notice.pipe— Pipe mail to thepipefwdparameter’s application. This parameter requires the File Storage role.
Enum"fwd""fail""blackhole""pipe"
Example: fwdopt=fwd
The domain whose default email behavior you want to configure.
Note:
This parameter defaults to the cPanel account’s main domain.
Example: domain=example.com
The failure message for the message’s sender.
Note:
Use this parameter if you used the fail method for the fwdopt parameter.
Default "No such person at this address"
Example: failmsgs=Failure echos loud. That address does not exist. Softly I regret. - an email failure haiku
The email address to which the system forwards messages.
Note:
Use this parameter if you used the fwd method for the fwdopt parameter.
Example: fwdemail=admin@example.com
The application to which the system pipes messages.
Note:
Use this parameter if you used the pipe method for the fwdopt parameter.
Important:
This parameter requires the File Storage role.
Example: pipefwd=mailscript.pl
- Mock server
https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/Email/set_default_address
- A server running cPanel.
https://cpanel-server.tld:2083/execute/Email/set_default_address
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
'https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/Email/set_default_address?fwdopt=fwd&domain=example.com&failmsgs=Failure+echos+loud.+That+address+does+not+exist.+Softly+I+regret.+-+an+email+failure+haiku&fwdemail=admin%40example.com&pipefwd=mailscript.pl'Response
application/json
{ "apiversion": 3, "func": "set_default_address", "module": "Email", "result": { "data": [ … ], "errors": null, "messages": null, "metadata": { … }, "status": 1, "warnings": null } }