# Add a new Email Inbox

POST /v3/email-inboxes

Add a new Email Inbox

Endpoint: POST /v3/email-inboxes
Security: API_Key

## Request fields (application/json):

  - `name` (string, required)
    Example: "Adove Campaign Holidays, Marketing Department"

  - `notes` (string)

  - `labelIds` (array)
    The ids of the labels to be associated to the Email Inbox
    Example: [223]

  - `subscribers` (object)

  - `subscribers.onReceived` (array)

  - `subscribers.onProcessed` (array)

  - `linkExclusionFilters` (array)

  - `omitSocialLinks` (boolean)

## Response 201 fields (application/json):

  - `id` (integer, required)
    Example: 10

  - `labelIds` (array, required)
    The ids of the labels associated to the Email Inbox
    Example: [223]

  - `name` (string, required)
    Example: "Christmas Marketing Campaign"

  - `emailAddress` (string, required)
    The email address that has been assigned to the inbox
    Example: "scanTest+<8^[a-z0-9]>@email.observepoint.com"

  - `notes` (string)

  - `subscribers` (object)

  - `subscribers.onReceived` (array)

  - `subscribers.onProcessed` (array)

  - `linkExclusionFilters` (array, required)

  - `omitSocialLinks` (boolean, required)

## Response 400 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)

## Response 401 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)

## Response 403 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)