Join the Ready, Set, Send Challenge Week 3. Share your QR code or landing page and win a badge!

[Integration] Clarification on best endpoint for subscription forms

user109669
Rookie
0 Votes

Hi,

We are currently integrating our App with Constant Contact and are evaluating the appropriate endpoint for subscription forms. Could you please advise on whether we should use the createContact(v3/contacts) or createOrUpdateContact(v3/contacts/sign_up_form) endpoint?

 

From our understanding, both methods seem to support double opt-in, depending on account settings. While the createOrUpdateContact(v3/contacts/sign_up_form) endpoint appears semantically suitable, our tests indicate that it can update contact fields without confirmation. Is this expected behavior?

 

Thank you for your assistance.

 

 

1 REPLY 1
John__B
Employee
0 Votes

Hello user109669,

 

Thank you for reaching out to Constant Contact API Developer Support. My team is here to assist outside software developers with questions about building into Constant Contact's API.

 

For sign-up form integrations, we typically recommend using the /sign_up_form endpoint, as it allows for an existing contact to have their profile updated with any new information being submitted, while the POST (create) request to the /contacts endpoint only allows for the creation of a new contact. If an existing contact’s information is submitted in a POST request to the /contacts endpoint, a 409 error is returned.

 

It is true that Confirm Opt-In is an account level setting that is applied to both methods. It is also expected behavior that an existing contact that has not yet confirmed their subscription can have their contact fields updated through the /sign_up_form endpoint. If Confirm Opt-In is enabled on an account, that contact can’t be sent campaigns until their subscription is confirmed. 

 

Please have a look and let us know if you have any other questions!

 

Regards,


John B.
API Support Specialist
Did I answer your question? If so, please mark my post as an "Accepted Solution" by clicking the Accept as Solution button in the bottom right hand corner of this post.
Resources
Developer Portal

View API documentation, code samples, get your API key.

Visit Page

Announcements

API Updates

Join our list to be notified of new features and updates to our V3 API.

Sign Up