---
title: "Add domain"
method: POST
path: "/email/1/domains"
tags: ["channels", "email", "email-domains"]
---

# Add domain

`POST /email/1/domains`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/email/1/domains`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

This method allows you to add new domains with a limit to create a maximum of 1000 domains in a day.

## Request body

- 34438aa163eb13a2a06ad96ae98170e41cc2ee8902e8b7655aba73ceb0bb23f1AddDomainRequest
  - `domainName` string, required: Unique name for the domain.
  - `dkimKeyLength` 1024 | 2048: Value for DKIM key length.
  - `targetedDailyTraffic` integer, required: Targeted daily traffic.
  - `applicationId` string: Required for application use in a send request for outbound traffic. Returned in notification events.
  - `entityId` string: Required for entity use in a send request for outbound traffic. Returned in notification events.

## Response `200`

OK

- 34438aa163eb13a2a06ad96ae98170e41cc2ee8902e8b7655aba73ceb0bb23f1DomainResponse: Detailed domain information.
  - `domainId` integer: Id of the domain.
  - `domainName` string: Name of the domain.
  - `active` boolean: Activation status of the domain.
  - `tracking` 34438aa163eb13a2a06ad96ae98170e41cc2ee8902e8b7655aba73ceb0bb23f1TrackingResponse: Tracking details of the domain.
    - `clicks` boolean: Indicates whether tracking of clicks is enabled.
    - `opens` boolean: Indicates whether tracking of opens is enabled.
    - `unsubscribe` boolean: Indicates whether tracking of unsubscribes is enabled.
  - `dnsRecords` 34438aa163eb13a2a06ad96ae98170e41cc2ee8902e8b7655aba73ceb0bb23f1DnsRecordResponse[]: DNS records for the domain.
    - `recordType` string: Type of the record.
    - `name` string: Name of the record.
    - `expectedValue` string: Expected value to be set for the given record.
    - `verified` boolean: Boolean value representing if the record is verified or not.
  - `blocked` boolean: Status if the domain is blocked.
  - `createdAt` string, date-time: Date the domain was created. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
  - `blocklistConfigurationLevel` 'FROM_SENDER' | 'FROM_DOMAIN': Defines the level at which Infobip stores unsubscribe preferences. Note: When you change the unsubscribe configuration from a more global level (such as FROM_DOMAIN) to a more specific level (such as FROM_SENDER), remember that anyone who previously unsubscribed at the domain level chose to stop receiving all messages from your domain. These existing unsubscribe records will not automatically update to reflect the new sender-level setting. As a result, individuals who unsubscribed from your domain will continue to not receive messages, even after the change. To prevent confusion and respect user preferences, carefully manage and, if necessary, update these records when altering unsubscribe settings.
  - `brandedDomainName` string: Branded tracking domain name assigned to the domain.

## Other responses

- `400`: Bad Request.
- `401`: Unauthorized
- `403`: Forbidden
- `409`: Domain already exists.
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)