The External ID field can be used to add a reference on customer accounts to an internal system
- Example: Customer number from PSA, CRM, accounting software, etc
This field is not visible to customers when logged into their own account. Only parent accounts (ie. partners) can view this field for their downstream customer accounts.
To access this field over the UI:
The field is located on the Profile page.
- Open Account Management from the menu
- Select Profile
- Click on Manage
- Fill in the External ID field
- Click Save
To access this field over the API:
API documentation can be found : https://us1.proofpointessentials.com/api/v1/docs/specification.php
The field can be accessed using ORGS endpoint.
GET {stack}.proofpointessentials.com/api/v1/orgs/{domain/eid}
Bulk GET requests are supported.
GET {stack}.proofpointessentials.com/api/v1/orgs/{domain/eid}/orgs
The field can be updated
PATCH {stack}.proofpointessentials.com/api/v1/orgs/{domain/eid}
Example body:
{
"external_id": "string"
}
If populated, monthly billing reports include the External ID field in both the raw data and on the pivot table summary.