---
title: "Create Nonprofit Addresses"
method: POST
path: "/v1/nonprofit_addresses"
tags: ["nonprofitAddresses"]
---

# Create Nonprofit Addresses

`POST /v1/nonprofit_addresses`

Submit mailing addresses for one or more nonprofits. Uploaded
addresses are used as suggestions for where to send disbursements.

## Request body

- object
  - `entries` NonprofitAddressSuggestionEntry[], required — Address entries to upload. Up to 500 per request.
    - `ein` string, required — The EIN of the nonprofit this address belongs to. Accepted as either nine digits (`123456789`) or `XX-XXXXXXX`.
    - `line1` string, required — Street address.
    - `line2` string — Optional suite, apartment, or unit.
    - `city` string, required — City.
    - `state` string, required — Two-letter US state code (uppercase).
    - `zip` string, required — US ZIP code. Five digits, optionally followed by a four-digit extension.

## Response `200`

All addresses were accepted.

## Other responses

- `400` — The request is invalid or contains invalid parameters
- `401` — Unauthorized. The request is missing the security (OAuth2 Bearer token) requirements and the server is unable to verify the identify of the caller.
- `403` — Access denied
- `404` — Resource Not Found
- `500` — Internal Server Error

## Changes

- **2026-06-29** `57a74bb24f2f` — 10 breaking, 25 info
  - removed the required property `code` from the response with the `400` status
  - removed the required property `code` from the response with the `401` status
  - removed the required property `code` from the response with the `403` status
  - removed the required property `code` from the response with the `404` status
  - …31 more
- **2026-06-29** `a7c21ea25028` — 5 warning
  - removed the optional property `details` from the response with the `400` status
  - removed the optional property `details` from the response with the `401` status
  - removed the optional property `details` from the response with the `403` status
  - removed the optional property `details` from the response with the `404` status
  - …1 more
- **2026-06-25** `073f90a1f000` — 15 info
  - added the optional property `details/items/debug` to the response with the `400` status
  - added the optional property `details/items/debug` to the response with the `401` status
  - added the optional property `details/items/debug` to the response with the `403` status
  - added the optional property `details/items/debug` to the response with the `404` status
  - …11 more
- …earlier changes not shown

[Full history](https://skmtc.dev/chariot-giving/apis/specs/changes/v1/nonprofit_addresses/post.md)

---

[API](https://skmtc.dev/chariot-giving/apis/specs.md) · [All operations](https://skmtc.dev/chariot-giving/apis/specs/llms.txt) · [OpenAPI document](https://skmtc.dev/chariot-giving/apis/specs/revisions/f305f0c14ede?raw)