---
title: "Add People to Approved Lists"
method: PATCH
path: "/v2/guest/approved_lists/add"
tags: ["Approved Lists"]
---

# Add People to Approved Lists

`PATCH /v2/guest/approved_lists/add`

Adds one or more people to one or more approved lists.
This operation is idempotent - calling it multiple times with the same data won't create duplicates.
People are matched by external_id first, then by email if no external_id is provided.

## Request body

- AddPeopleRequest — Request to add people to approved lists
  - `people` PersonToAdd[], required — List of people to add to approved lists.
    - `address` string — The person's street address.
    - `approved_list_ids` string[], required — List of one or more approved list IDs to add the person to.
    - `date_of_birth` string — The person's date of birth in YYYY-MM-DD format.
    - `email` string, required — The person's email address.
    - `expiration_timestamp` string — ISO 8601 formatted expiration time for the approved list entry. This will be shared by all entries corresponding to this person.
    - `external_id` string — Stable external identifier. This can be used to ensure that changes are to the same person as well as ease syncing with an external system. Must be unique to the person within the organization if used.
    - `full_name` string, required — The person's full name.
    - `phone_number` string — The person's phone number.

## Response `200`

OK

- CountResponse — Response containing a count of affected records
  - `count` integer, required — Number of records added, removed, or changed by the operation.

---

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