---
title: "Bulk add subscribers to forms"
method: POST
path: "/v4/bulk/forms/subscribers"
tags: ["Forms"]
---

# Bulk add subscribers to forms

`POST /v4/bulk/forms/subscribers`

Adding subscribers to double opt-in forms will trigger sending an Incentive Email. Subscribers already added to the specified form will not receive the Incentive Email again. For more information about double opt-in see "[Double opt-in](#double-opt-in)". <br/><br/>The subscribers being added to the form must already exist. Subscribers can be created in bulk using the "[Bulk create subscriber](#bulk-create-subscribers)" endpoint.<br/><br/>See "[Bulk & async processing](#bulk-amp-async-processing)" for more information.

## Request body

- object
  - `additions` object[], required
    - `form_id` integer, nullable, required
    - `subscriber_id` integer, nullable, required
    - `referrer` string
  - `callback_url` string, nullable

## Response `200`

Adds subscribers to forms synchronously when 100 or less form/subscribers are requested

- object
  - `subscribers` object[], required
    - `id` integer, required
    - `first_name` string, required
    - `email_address` string, required
    - `created_at` string, required
    - `added_at` string, required
    - `referrer` string, required
    - `referrer_utm_parameters` object, required
      - `source` string, required
      - `medium` string, required
      - `campaign` string, required
      - `term` string, required
      - `content` string, required
  - `failures` object[], required
    - `errors` string[], required
    - `subscription` object, required
      - `form_id` integer, nullable, required
      - `subscriber_id` integer, nullable, required
      - `referrer` string, required

## Other responses

- `202` — Adds subscribers to forms asynchronously when more than 100 form/subscribers are requested
- `401` — Returns a 401 if the token and/or account cannot be authenticated
- `413` — Returns a 413 when the size of the request would exceed the account's data limit for enqueued bulk requests
- `422` — Returns a 422 when `additions` is empty or not an array

---

[API](https://skmtc.net/kit/apis/kit-api.md) · [All operations](https://skmtc.net/kit/apis/kit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kit/kit-api/revisions/0df0c90d12da/schema)