> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.givechariot.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.givechariot.com/_mcp/server.

# Create Nonprofit Addresses

POST https://api.givechariot.com/v1/nonprofit_addresses
Content-Type: application/json

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

Reference: https://docs.givechariot.com/api/nonprofit-addresses/create

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Servers

- `https://api.givechariot.com` (Production, default)
- `https://sandboxapi.givechariot.com` (Sandbox)

## Request

### Body (application/json)

This endpoint expects an object.

- `entries` (list of NonprofitAddressSuggestionEntry, required) — Address entries to upload. Up to 500 per request.

## Response

### 200

All addresses were accepted.

## Errors

### 400 Bad Request Error

The request is invalid or contains invalid parameters

- `type` (string, required) — A URI reference identifying the problem type.
- `title` (string, required) — A short, human-readable summary of the problem type.
- `status` (integer, required) — The HTTP status code for this error.
- `detail` (string, required) — A human-readable explanation specific to this occurrence.

### 401 Unauthorized Error

Unauthorized. The request is missing the security (OAuth2 Bearer token) requirements and the server is unable to verify the identify of the caller.

- `type` (string, required) — A URI reference identifying the problem type.
- `title` (string, required) — A short, human-readable summary of the problem type.
- `status` (integer, required) — The HTTP status code for this error.
- `detail` (string, required) — A human-readable explanation specific to this occurrence.

### 403 Forbidden Error

Access denied

- `type` (string, required) — A URI reference identifying the problem type.
- `title` (string, required) — A short, human-readable summary of the problem type.
- `status` (integer, required) — The HTTP status code for this error.
- `detail` (string, required) — A human-readable explanation specific to this occurrence.

### 404 Not Found Error

Resource Not Found

- `type` (string, required) — A URI reference identifying the problem type.
- `title` (string, required) — A short, human-readable summary of the problem type.
- `status` (integer, required) — The HTTP status code for this error.
- `detail` (string, required) — A human-readable explanation specific to this occurrence.

### 500 Internal Server Error

Internal Server Error

- `type` (string, required) — A URI reference identifying the problem type.
- `title` (string, required) — A short, human-readable summary of the problem type.
- `status` (integer, required) — The HTTP status code for this error.
- `detail` (string, required) — A human-readable explanation specific to this occurrence.

## Types

### NonprofitAddressSuggestionEntry

A mailing address uploaded for a nonprofit, identified by its EIN.

- `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.
- `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.
- `line2` (string, optional) — Optional suite, apartment, or unit.

## Examples

**Request**

```json
{
  "entries": [
    {
      "ein": "13-1635294",
      "line1": "431 18th Street NW",
      "city": "Washington",
      "state": "DC",
      "zip": "20006"
    },
    {
      "ein": "530196605",
      "line1": "1250 24th Street NW",
      "city": "Washington",
      "state": "DC",
      "zip": "20037-1175",
      "line2": "Suite 300"
    }
  ]
}
```

**Response**

```json
{}
```