Custom form
Integrate with Cocoonmail via a form endpoint, which will work with any type of custom form solution you have set up.
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.
- Find Settings and Copy the URL shown in the Form Endpoint field.


Create a form
In a form, add input
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.
When adding new fields, click on Create field to create attribute for each field.


Here’s a simple example form that collects name, email address and assigns a custom user group:
Submit with JavaScript
If you would rather submit a form using JavaScript, you can make a POST
request to your form endpoint.
Make sure to set the Content-Type
header to application/x-www-form-urlencoded
.
Responses from this form endpoint will be one of the following:
This endpoint is rate limited. If you go over the limit, will see a HTTP 429
error just like with the API. Read more about how to handle 429 responses