> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create address

> Use this endpoint to create an address resource.

POST/fundingsources/addresses

Use this endpoint to create an address resource.

When creating the address, you must pass the token of either an existing user in the `user_token` field or an existing business in the `business_token` field. Do not pass both.

## Request body

| Fields | Description |
| - | - |
| active boolean  Optional | Specifies whether the address is active. **Allowable Values:**  `true`, `false` **Default value:** `true` |
| address\_1 string  Required | Street name and number of the address. **Allowable Values:**  255 char max |
| address\_2 string  Optional | Additional address information. **Allowable Values:**  255 char max |
| business\_token string  Optional | Unique identifier of the business account holder. This token is required if a `user_token` is not specified. **Allowable Values:**  1–36 chars |
| city string  Required | City of the address. **Allowable Values:**  40 char max |
| country string  Required | Country of the address. **Allowable Values:**  1–40 chars |
| first\_name string  Required | First name or given name of the account holder. **Allowable Values:**  40 char max |
| is\_default\_address boolean  Optional | A value of `true` specifies that this address is the default address used by the account holder's funding source. If this is the account holder's only address, it is used as the default regardless of this field's setting. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| last\_name string  Required | Last name or family name of the account holder. **Allowable Values:**  40 char max |
| phone string  Optional | Telephone number of the account holder. **Allowable Values:**  255 char max |
| postal\_code string  Optional | Postal code of the address. **Allowable Values:**  10 char max |
| state string  Required | Two-character state, provincial, or territorial abbreviation. For the complete list, see [Valid state, provincial, territorial, and federal abbreviations](https://www.marqeta.com/docs/core-api/kyc-verification/perform.md#_valid_state_provincial_territorial_and_federal_abbreviations). **Allowable Values:**  2 char max |
| token string  Optional | Unique identifier of the address. If you do not include a token, the system will generate one automatically. This token is necessary for use in other API calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated. **Allowable Values:**  1–36 chars |
| user\_token string  Optional | Unique identifier of the user account holder. This token is required if a `business_token` is not specified. **Allowable Values:**  1–36 chars |
| zip string  Optional | United States ZIP code. This field is required if `postal_code` is not specified. **Allowable Values:**  10 char max |

## Sample request body

```json JSON lines wrap theme={null}
{
  "token": "my_funding_source_address_biz_01",
  "city": "Berkeley",
  "state": "CA",
  "postal_code": "94705",
  "zip": "94705",
  "country": "USA",
  "phone": "5104444444",
  "business_token": "my_business_01",
  "first_name": "Jane",
  "last_name": "Doe",
  "address_1": "1234 Grove Street"
}
```

## Response body

| Fields | Description |
| - | - |
| active boolean  Conditionally returned | Specifies whether the address is active. This field is returned if it exists in the resource. **Allowable Values:**  `true`, `false` |
| address\_1 string  Returned | Street name and number of the address. **Allowable Values:**  255 char max |
| address\_2 string  Conditionally returned | Additional address information. This field is returned if it exists in the resource. **Allowable Values:**  255 char max |
| business\_token string  Conditionally returned | Unique identifier of the business account holder. This token is returned if a `user_token` is not specified. **Allowable Values:**  1–36 chars |
| city string  Returned | City of the address. **Allowable Values:**  40 char max |
| country string  Returned | Country of the address. **Allowable Values:**  1–40 chars |
| created\_time datetime  Returned | Date and time when the resource was created, in UTC. **Allowable Values:**  datetime **Format:** yyyy-MM-ddThh:mm:ssZ |
| first\_name string  Returned | First or given name of the cardholder. **Allowable Values:**  40 char max |
| is\_default\_address boolean  Conditionally returned | A value of `true` specifies that this address is the default address used by the account holder's funding source. If this is the account holder's only address, it is used as the default regardless of this field's setting. This field is returned if it exists in the resource. **Allowable Values:**  `true`, `false` |
| last\_modified\_time datetime  Returned | Date and time when the resource was last modified, in UTC. **Allowable Values:**  datetime **Format:** yyyy-MM-ddThh:mm:ssZ |
| last\_name string  Returned | Last name or family name of the cardholder. **Allowable Values:**  40 char max |
| phone string  Conditionally returned | Telephone number of the cardholder. This field is returned if it exists in the resource. **Allowable Values:**  255 char max |
| postal\_code string  Returned | Postal code of the address. **Allowable Values:**  10 char max |
| state string  Returned | Two-character state, provincial, or territorial abbreviation. For the complete list, see [Valid state, provincial, territorial, and federal abbreviations](https://www.marqeta.com/docs/core-api/kyc-verification/perform.md#_valid_state_provincial_territorial_and_federal_abbreviations). **Allowable Values:**  2 char max |
| token string  Returned | Unique identifier of the address object. **Allowable Values:**  1–36 chars |
| user\_token string  Conditionally returned | Unique identifier of the user account holder. This token is returned if a `business_token` is not specified. **Allowable Values:**  1–36 chars |
| zip string  Returned | United States ZIP code of the address. This field is returned if `postal_code` is not specified. **Allowable Values:**  10 char max |

## Sample response body

```json JSON lines wrap theme={null}
{
  "business_token": "my_business_01",
  "token": "my_funding_source_address_biz_01",
  "first_name": "Jane",
  "last_name": "Doe",
  "address_1": "1234 Grove Street",
  "city": "Berkeley",
  "state": "CA",
  "postal_code": "94705",
  "zip": "94705",
  "country": "USA",
  "phone": "5104444444",
  "is_default_address": true,
  "active": true,
  "created_time": "2023-02-20T20:04:13Z",
  "last_modified_time": "2023-02-20T20:04:13Z"
}
```


## Related topics

- [Addresses Overview](https://www.marqeta.com/docs/core-api/addresses.md)
- [Create card](https://www.marqeta.com/docs/core-api/cards/create-card.md)
- [Create GPA unload](https://www.marqeta.com/docs/core-api/gpa-orders/gpa-unloads/create-unload.md)
- [Create business](https://www.marqeta.com/docs/core-api/businesses/create-business.md)
- [Create account card](https://www.marqeta.com/docs/core-api/credit-account-cards/create-account-card.md)