Update readme to document differences with core API

Richrequested to merge
artfulrobot/emailapi:update-readme into master

With this, we probably don't need !26 (closed)

Merge request reports