---
title: "Add signups"
method: PATCH
path: "/api/v2/lists/{id}/add_signups"
tags: ["Lists"]
---

# Add signups

`PATCH /api/v2/lists/{id}/add_signups`

## Request

- Base URL: `https://yournation.nationbuilder.com`
- URL: `https://yournation.nationbuilder.com/api/v2/lists/{id}/add_signups`
- Auth: HTTP bearer

Add Signup IDs to list via an asynchronous process.
Returns the token of an asynchronous process that can be queried using another endpoint.
Accepts up to 10,000 signup IDs in a single payload.

## Request body

- object
  - `data` object
    - `id` string, required: The ID of the list to add signups to.
    - `type` 'lists', required: Resource type. Must always be lists.
    - `signup_ids` unknown[], required: IDs of the signups to add to custom list.
      - unknown

## Response `202`

A token for tracking the asynchronous add-signups process.

- object
  - `token` string

## Other responses

- `400`: The add-signups request exceeded the maximum of 10,000 signup IDs.
- `401`: The access token is missing, expired, or not authorized to access this resource.
- `404`: No resource exists with the provided ID.
- `429`: The access token has exceeded its request quota for the current rate-limit window.

## Changes

- **2026-11-05** `d5c88ca497ac`: 1 breaking, 7 info
  - the `type` request property const value `lists` was added
  - added the media type `application/vnd.api+json` to the request body
  - media type `application/json` was changed to a more specific media type `application/vnd.api+json` for the response status `202`
  - added the non-success response with the status `401`
  - …4 more

[Operation history](https://skmtc.dev/nationbuilder/apis/nationbuilder-v2-api/changes/api/v2/lists/:id/add_signups/patch.md)

---

[API](https://skmtc.dev/nationbuilder/apis/nationbuilder-v2-api.md) - [All operations](https://skmtc.dev/nationbuilder/apis/nationbuilder-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nationbuilder/apis/nationbuilder-v2-api/revisions/d5c88ca497ac?raw)