> This page is for Afterpay Online Developer, version v1.
> For other versions, use one of these documentation indexes:
> - Main (default): https://developers.afterpay.com/afterpay-online-developer/main/llms.txt
> - v1: https://developers.afterpay.com/afterpay-online-developer/v-1/llms.txt
> - Chinese: https://developers.afterpay.com/afterpay-online-developer/chinese/llms.txt

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

# Contact object

## Attributes

| Attribute   | Type              | Description                                                                                                                           |
| ----------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| name        | string (required) | Full name of contact. Limited to 255 characters.                                                                                      |
| line1       | string (required) | First line of the address. Limited to 128 characters.                                                                                 |
| line2       | string            | Second line of the address. Limited to 128 characters.                                                                                |
| suburb      | string            | City or suburb name. Limited to 128 characters.                                                                                       |
| state       | string            | State (or Town/City for NZ). Limited to 128 characters.                                                                               |
| postcode    | string (required) | [ZIP](https://en.wikipedia.org/wiki/ZIP_Code) or [postal code](https://en.wikipedia.org/wiki/Postal_code). Limited to 128 characters. |
| countryCode | string (required) | The two-character [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1) country code.                                                |
| phoneNumber | string (required) | The phone number, in [E.123](https://en.wikipedia.org/wiki/E.123) format. Limited to 32 characters.                                   |

## Example Contact Object

### Australia

```json
{
  "name": "Joe Consumer",
  "line1": "Level 5",
  "line2": "406 Collins Street",
  "suburb": "Melbourne",
  "state": "VIC",
  "postcode": "3000",
  "countryCode": "AU",
  "phoneNumber": "0400 000 000"
}
```

### New Zealand

```json
{
  "name": "Joe Consumer",
  "line1": "75 Queen St",
  "suburb": "Auckland Central",
  "state": "Auckland",
  "postcode": "1010",
  "countryCode": "NZ",
  "phoneNumber": "0200 000 000"
}
```

### United States of America

```json
{
  "name": "Joe Consumer",
  "line1": "3655 Lawton St",
  "suburb": "San Francisco",
  "state": "CA",
  "postcode": "94122",
  "countryCode": "US",
  "phoneNumber": "(415) 200-0000"
}
```