Generate the form
Easily generate an HTML or JSX form for collecting new signups for your mailing list from inside Cocoonmail. Go to the Forms page, customize your form (such as mailing list, layout, button color and success message) and copy the HTML into your website.

Add more fields to the form
It’s possible to add other fields to your form if you want to collect more than just email addresses. When adding new fields, use the “API Name” value found from your API settings page as thename
attribute for each field.
For example, this field would collect a First Name:
Custom form
Our form endpoint lets you add new contacts to your audience from an HTML form or using JavaScript. Find the form endpoint To submit data to Cocoonmail you will need to retreive the form endpoint URL that’s linked to your Cocoonmail account.- Go to the Forms page in your Cocoonmail account.
- Click on the Settings tab.
- Copy the URL shown in the Form Endpoint field.


Create a form
In a form, addinput
elements for each of the contact properties you want to collect.
You can add fields for any of the default contact properties plus any of your custom properties.
For each form field use the “API Name” value found from your API settings page as the name
attribute.


If you need a hand integrating with your custom form, just shoot adam@cocoonmail.com an email and we’ll help you integrate with anything your specific setup ✌️
Submit with JavaScript
If you would rather submit a form using JavaScript, you can make aPOST
request to your form endpoint.
Make sure to set the Content-Type
header to application/x-www-form-urlencoded
.
HTTP 429
error just like with the API. Read more about how to handle 429 responses
FAQ
I'm receiving an error from the form endpoint.
I'm receiving an error from the form endpoint.
We rate limit requests from the same IP to once per minute and also do not allow duplicates of the same email address. It’s likely the error is related to one of these cases.