# Create Sender

Create a new sender email address or domain. The e-mail address or domain has to be registered and validated before being used to send e-mails. Validation is done via /sender/{sender_id}/validate. In order to manage a sender available across multiple API Keys, see the related /metasender resource.

> Note: The maximum number of senders and metasenders per user is 100. This includes both validated (Active) and non-validated (Inactive) ones, but does not include Deleted senders / metasenders.

Endpoint: POST /v3/REST/sender
Version: 1.0.0
Security: basicAuth

## Request fields (application/json):

  - `Email` (string, required)
    The email address or domain for this sender.

  - `EmailType` (string)
    Type of emails this sender will send. This is for purely informative purposes - the values do not place any sending restrictions on the sender email or domain.

- transactional - transactional emails
- bulk - campaign emails
- unknown - both

  - `IsDefaultSender` (boolean)
    Indicates whether this is the default sender or not.

  - `Name` (string)
    User-provided name for this sender.

## Response 201 fields (application/json):

  - `Count` (integer)
    Indicates the number of objects in the Data array.

  - `Data` (array)
    A JSON array containing a list of objects returned by this endpoint.

  - `Data.CreatedAt` (string)
    Timestamp indicating when this sender object was created.

  - `Data.DNSID` (integer)
    Unique numeric ID of the DNS domain to which sender belongs. When the sender is inactive, the DNSID will return a -1 value.

  - `Data.Email` (string)
    The email address or domain for this sender.

  - `Data.Filename` (string)
    Filename expected on the domain name webserver. Will only return a value when a sender domain is registered. Used to validate the sender via the /sender/{sender_id}/validate resource.

  - `Data.ID` (integer)
    Unique numeric ID of this sender.

  - `Data.Status` (string)
    The status of this sender.

Possible values:

- Inactive
- Active
- Deleted

  - `Data.EmailType` (string)
    Type of emails this sender will send. This is for purely informative purposes - the values do not place any sending restrictions on the sender email or domain.

- transactional - transactional emails
- bulk - campaign emails
- unknown - both

  - `Data.IsDefaultSender` (boolean)
    Indicates whether this is the default sender or not.

  - `Data.Name` (string)
    User-provided name for this sender.

  - `Total` (integer)
    Indicates the number of objects in the Data array.


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 429 fields

## Response 500 fields