# Add subscribers to MailerLite

> Formspree Docs · Using the CLI · Updated July 14, 2023

The **add subscriber** action adds subscribers to MailerLite. Under the hood, this action calls the [create subscriber](https://developers.mailerlite.com/reference#create-a-subscriber) API endpoint. Also, you may want to [add the subscriber to a group.](https://developers.mailerlite.com/reference#add-single-subscriber)

Adding the **add subscriber** action in the `formspree.json` file has the same effect as adding the MailerLite plugin in the Formspree dashboard. See the [MailerLite plugin help article](/articles/plugins/use-mailerlite-to-create-subscribers/) for more information. 

## Formspree.json configuration

| Key | Type | Description |
| --- | --- | --- |
| `app` |  String | Must be `mailerlite`  |
| `apiKey` |  String | Your MailerLite API key found [here](https://app.mailerlite.com/integrations/api/) (must be an $ env variable reference, required) |
| `type` |  String | Must be `addSubscriber` |
| `groupName` |  String | Optional. Group where subscribers will be added. Default: **empty** |
| `resubscribe` |  Boolean | Optional. Reactivates the subscriber if the value is **true**. Default: **false** |
| `autoresponders` |  Boolean | Optional. Enable subscription autoresponders. Only takes effect if **groupName** is not empty. Default: **false** |
| `subscriberStatus` |  Enum | Optional. One of **unsubscribed, active,** or **unconfirmed**. Default: **active** |
| `requireOptin` |  Boolean | Optional. If **true**, enables the opt-in field: Submissions will only be sent to MailerLite if there is a field named `_optin` with a non-empty value in the data. Default: **false** |

#### **Notes**

**autoresponders:** This only takes effect if a group is selected. If it's enabled, the selected group autoresponders will be sent.

**resubscribe:** If it's enabled and the sent email is on your subscriber list, the **Subscriber Status** will be ignored and the subscriber reactivated.  
Be aware that it only works for emails that once have been added to your subscriber list. For new emails, the **Subscriber Status** will be taken instead. 

**requireOptin:** Instead of adding a contact to the MailerLite list each time the form is submitted, the **Opt-in Checkbox** setting will first check the presence of an `_optin` special field to determine if the plugin should be dispatched.

#### **Example**

```javascript
{
  "forms": {
    "contact": {
      "name": "Contact Form",
      "actions": [
        {
          "app": "mailerlite",
          "apiKey": "$MAILERLITE_API_KEY",
          "type": "addSubscriber",
          "groupName": "Formspree Test",
          "resubscribe": false,
          "autoresponders": false,
          "subscriberStatus": "active",
          "requireOptin": false
        }
      ]
    }
  }
}
```

## Validation rules

The **add subscriber** action adds the following validation rules implicitly:

| Field | Validation Rule |
| --- | --- |
| `_replyto` or `email` | Required |
| `_replyto` | Type is `email` |
| `email` | Type is `email` |