Showing results for 
Search instead for 
Did you mean: 
We had to temporarily close one of our support sites. You may experience a longer than normal wait time when calling into our support center. Remember to check out all of our available support resources including live chat for the quickest response.

Set status to opt-out during contact creation in v1 of API

Occasional Visitor

Set status to opt-out during contact creation in v1 of API

Hello, I am hoping to set the status value of contacts during creation with the v1 API.  There is an opt-in / opt-out checkbox on the form we are using to trigger contact creation, but it seems that setting the Status value of the contact to OPTOUT, rather than ACTIVE during creation still places the created user in under Active contacts.  Can this be done without a separate call to the opt-out API endpoint after user creation, or is this something I perhaps need to upgrade to the v2/v3 API to achieve in a single creation call.


Thank you.


Re: Set status to opt-out during contact creation in v1 of API


Thanks for reaching out to Constant Contact's API Support team.


You should definitely consider upgrading to using our v2 or v3 API (which one depends on whether you are needing to use more than just contacts features). In our v1 and v2 APIs we don't have a single call to create an individual contact and unsubscribe them at the same time. The process you would follow for our v2 API would be as follows:

- GET the contact by email address to see if they exist.
  - If they do, you can make a DELETE call to the returned contact ID to unsubscribe the existing contact.
  - If they do not exist, you would POST the contact to create them first. The response will include the newly created contact ID which you would then DELETE to unsubscribe them.

When using our v3 API you can set a contact's "permission_to_send" status to "unsubscribed" while you are creating them to immediately opt them out.

Please let us know if you have any other questions!

David B.
Tier II API Support Engineer