Emails can only be sent to existing prospects

[pardot]

Emails can only be sent to existing prospects

[hatzopoulos]

In my case, I have noticed that error code 3 (Invalid prospect ID) will be returned by calls to /api/email/version/3/do/send/prospect_email/ when the prospect exists but has opted_out of receiving email. Rather then saying it failed because of an opt out situation.

Without checking if the prospect is existing and opted in first it can can lead to less then optimal code or logic being designed where one could think the prospect doesn't exist and try to create it but then that would lead to error 9. Example:

1. send one to one email api/email/version/3/do/send/prospect_email/[email protected]?params
2. caught response: Invalid prospect ID (strange because you would expect Invalid prospect Email)
3. ok so send request to create new prospect: api/prospect/version/3/do/create/email/<email>
4. caught response: Error (9): A prospect with the specified email address already exists

After checking the prospect using api/prospect/version/3/do/read/email you may find..
recent_interaction => Opted Out
is_do_not_email => 1
opted_out => 1

It would be helpful if the opt out reason was returned possibly as a new error code.