## Overview

Create a new email address.

## Summary

In the event that the email address already exists, that record will be returned without making any changes.

## Request Arguments

Name | Type | Description | Required
--- | --- | --- | ---
email_address | String | The email address. | True
invalid_email | Boolean | true if the email address is invalid. false is the default. | False
opt_out | Boolean | true if the email address is opted out. false is the default. | False

### Request

    {
      "email_address": "eharmon@example.com",
      "invalid_email": false,
      "opt_out": false
    }

## Response Arguments

Name | Type | Description
--- | --- | ---
<record field> | <record field type> | Returns the fields for the newly created record.

### Response

    {
      "id": "a028341c-ba92-9343-55e7-56cf5beda121",
      "date_created": "2016-02-25T11:53:07-08:00",
      "date_modified": "2016-02-25T11:53:07-08:00",
      "deleted": false,
      "email_address": "eharmon@example.com",
      "email_address_caps": "EHARMON@EXAMPLE.COM",
      "invalid_email": false,
      "opt_out": false,
      "_acl": {
        "fields": {}
      },
      "_module": "EmailAddresses"
    }

## Change Log

Version | Change
--- | ---
v10 | Added `/EmailAddresses` POST endpoint.