Where to get the Proofpoint Essentials API
The API is available across all stacks. As a reference point, you can get to the API documentation here:
These are public facing URLs and do not require for you to be logged in to see.
What the API can do for you
The API allows admins to administrate the account without having to interact with the Proofpoint Essentials interface, i.e. the web UI.
In the API, these are items that can be done, but not limited to:
- Checking the domain settings: checking the individual domain through the domains tab.
- Check what features are enabled: checking the settings in the features tab
- Update individual user items like the approve sender list: going directly to the user profile and add in items to the approve list.
There are many other items that can be updated, changed, or removed with the API.
Proofpoint support does not offer any specific coding, or assistance with coding. All coding must be done by the customer side. We are unable to help with any custom coding, as the API can be used with any preferred coding method use to connect to our system.
A specific call does not work
In respect to coding, if a call gives a specific error, there are items that need to be adhered to.
An Admin level account is required.
Organization admin - allowed only to work on the same account level
Strategic Partner/Channel Admin - allowed to work on the same domain as well as their customer accounts.
The coding to connect requires a connection with the Base URL, along with the path: /api/v1. Make sure to appropriately use the base path of the stack of the domain you are working with is specifically on.
API calls are stack dependent, if you only have credentials for one stack i.e. US5 you will have to validate your credentials against that URL
Along with the base URL path, you can edit one of the resources:
As most APIs, the most common methods using the calls will be GET and PUT.
See the specification page to see each resource and their associated methods. Some methods are not offered on a particular resource.