Atlas L6ynztjd84

Stay updated on the status of all your company's support tickets.

Customer portal

Collect signups from any web page with a customizable form.

You may want to collect signups from your website directly into Loops.

Easily generate an HTML or JSX form for collecting new signups for your mailing list from inside Loops.

Here you will see settings to manage features of your form:

When you're happy with your form, copy the HTML into your website.

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 

For example, this field would collect a First Name:

If you want more flexibility when creating signup forms, 

Simple form

Integrate with Loops via a form endpoint, which will work with any type of custom form solution you have set up.

Our form endpoint lets you add new contacts to your audience from an HTML form or using JavaScript.

To submit data to Loops you will need to retreive the form endpoint URL that's linked to your Loops account.

 elements for each of the contact properties you want to collect.

For each form field use the "API Name" value found from your 

Here's a simple example form that collects name, email address and assigns a custom user group:

To add subscribers to mailing lists, include a hidden field called 

. You can use a single mailing list ID or to add subscribers to multiple lists, use a comma-separated list of mailing list IDs.

Make sure that any mailing list you add to a form is [Public](/contacts/mailing-lists#list-visibility). You cannot subscribe contacts to private mailing lists from the form endpoint.

If you need a hand integrating with your custom form, just shoot [adam@loops.so](mailto:adam@loops.so) an email and we'll help you integrate with anything your specific setup ✌️

If you would rather submit a form using JavaScript, you can make a 

function handleSubmit() {
  const formBody = `firstName=${encodeURIComponent(firstName)}&email=${encodeURIComponent(email)}&mailingLists=${encodeURIComponent(mailingListIds)}`;

  // Change this URL to your own endpoint URL
  fetch("https://app.loops.so/api/newsletter-form/YOUR_FORM_ENDPOINT", {
    method: "POST",
    body: formBody,
    headers: {
      "Content-Type": "application/x-www-form-urlencoded",
    },
  });
}


Responses from this form endpoint will be one of the following:

HTTP 400 or 500

{
  success: false,
  message: "A descriptive error message."
}


This endpoint is rate limited. If you go over the limit, will see a 

Read more about how to handle 429 responses

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.