I had Technical Support Case #09045069 in relation to this issue. I was told to get the API documents corrected, I needed to post to here.
Update API Documentation
Some (all?) of the API calls related to Alternate Email Addresses require both an Enterprise Account and to be manually activated by Smartsheet Support.
The API documents do not make this clear.
Only last API promote-alternate-email call mentions this in restriction in it's Permissions.
This should be mentioned on all of the API calls that have this requirement. For example, there is no mention of this requirement on the "Add alternate emails" call which I was trying to use.
There should also be a mention that some (or all of these calls) are so restricted in the introduction to the Alternate Email Addresses API section.
Improve the API Error Codes
When I ran into this problem making calls to add an alternate email address, I had the following API error retruned:
```json
{
"errorCode" : 4000,
"message" : "An unexpected error has occurred. Please contact the Support team at https://help.smartsheet.com/contact for assistance.",
"refId" : "k3ki9w"
}
```
The code is not very informative. I fact after after 7 years of working with the Smartsheet API, I associated it a variety of issues often related to back-end issues wiht Smartsheet's servers.
This should return a error that says that the request requires both an Enterprise Account and to be enabled by Smartsheet Support.
(NOTE: I do have an Enterprise Account, and now have this feature enabled)
