Can I create a new contact with an email status other than "NonMarketable"?

API Q&A
1

I have a customized plug-in, part of a WooCommerce website, that interprets a form and creates or updates a Keap contact based on the form contents. I’m using the InfusedWoo plug-in to communicate with Keap. When the form processor plug-in creates a new contact, the contact is always created with a status of “Non-marketable”. I want to change this so that the new contact will receive an email offering them the chance to opt-into marketing. But I’m not sure of either the right way to change the status or what I should change the status to.

Is there a way to have the new contact created with a different status than “non-marketable”? Or do I have to create the contact and then reset the status? Either way, is there a written guide anywhere to what values are possible for ‘email_status’, and exactly what they mean, so that I know what new status to assign?

Thanks.

2

This is listed under the REST V1 API

There’s also an endpoint under the XMLRPC API as well

3

Hi Marion,

Thanks for the links. The REST API link is useful, but I still have questions. In particular, which status value will do what I want? I don’t want to just add a new contact to our email lists and start sending them marketing emails because they signed this form. Instead, I want to send each new contact just a single email, one that asks if they want to receive marketing emails from us. Is this what the “Marketable” status does? The use of the “opt_in_reason” field is also confusing, because the new contact hasn’t opted-into marketing yet; I want to ask them if they want to opt-into marketing.

4

I think what you want to do is create an Automation and use an Email Confirmation Sequence, and then you can use the REST v2 API to push them into the sequence.

5

Hi Marion,

Will creating an automated Email Confirmation Sequence the way you describe work even with a contact whose current email_status = “Non-marketable”? I thought that the “Non-marketable” status would block all emails, of any description.

Thanks.

6

I would ask Keap support to confirm, but yes, it should, because it’s designed to confirm the contacts email address, and their intent to receive emails from you.

Here’s the documentation on the different email statuses:

7

I believe I have the information I need. Thanks for your help.