I don't see any methods on the API like getLastErrorMessage() to get an idea of the internal state or why I was using the API incorrectly. If they don't exist please can you add them in future releases so that someone without a copy of the C/C++ source code can debug their applications.
Three reasons could rise annotation creation failure:
- you aren't activating a Professional or Premium license
- you're working on a file without writing permissions
- you're working on a file with limited password (not owner)