---
title: "Add domain"
method: POST
path: "/v1/domains"
tags: ["domains"]
---

# Add domain

`POST /v1/domains`

## Request

- Base URL: `https://api.morningscore.io`
- URL: `https://api.morningscore.io/v1/domains`
- Auth: HTTP bearer

Registers a new website URL on the authenticated account. Responses use `201 Created` with global domain and company identifiers; subscriber caches refresh.

## Request body

- object: Hostname to register plus search market (e.g. `da_dk` for Danish in Denmark, `en_us` for English in the United States).
  - `domain` string, required
  - `market` 'ps_af' | 'sq_al' | 'ar_dz' | 'kg_ao' | 'en_ai' | 'es_ar' | 'hy_am' | 'en_au' | 'de_at' | 'az_az' | 'en_bs' | 'ar_bh' | 'bn_bd' | 'be_by' | 'nl_be' | 'en_bz' | 'fr_bj' | 'es_bo' | 'bs_ba' | 'tn_bw' | 'pt_br' | 'zh_bn' | 'bg_bg' | 'fr_bf' | 'fr_bi' | 'km_kh' | 'fr_cm' | 'en_ca' | 'pt_cv' | 'fr_cf' | 'ar_td' | 'es_cl' | 'zh_cn' | 'es_co' | 'en_ck' | 'es_cr' | 'fr_ci' | 'hr_hr' | 'es_cu' | 'en_cy' | 'cs_cz' | 'sw_cd' | 'da_dk' | 'en_dm' | 'es_do' | 'es_ec' | 'ar_eg' | 'es_sv' | 'et_ee' | 'am_et' | 'en_fj' | 'fi_fi' | 'fr_fr' | 'fr_ga' | 'en_gm' | 'ka_ge' | 'de_de' | 'ak_gh' | 'en_gi' | 'el_gr' | 'da_gl' | 'fr_gp' | 'es_gt' | 'en_gg' | 'en_gy' | 'fr_ht' | 'es_hn' | 'zh_hk' | 'hu_hu' | 'is_is' | 'bn_in' | 'jw_id' | 'ar_iq' | 'en_ie' | 'en_im' | 'iw_il' | 'it_it' | 'en_jm' | 'ja_jp' | 'en_je' | 'ar_jo' | 'kk_kz' | 'sw_ke' | 'en_ki' | 'ar_kw' | 'ky_kg' | 'lo_la' | 'lv_lv' | 'ar_lb' | 'ar_ly' | 'de_li' | 'lt_lt' | 'fr_lu' | 'mk_mk' | 'fr_mg' | 'en_my' | 'mt_mt' | 'es_mx' | 'mo_md' | 'mn_mn' | 'bs_me' | 'en_ms' | 'ar_ma' | 'ny_mz' | 'af_na' | 'en_nr' | 'ne_np' | 'nl_nl' | 'en_nz' | 'es_ni' | 'fr_ne' | 'en_ng' | 'en_nu' | 'no_no' | 'ar_om' | 'ur_pk' | 'ar_ps' | 'es_pa' | 'es_py' | 'es_pe' | 'tl_ph' | 'pl_pl' | 'pt_pt' | 'es_pr' | 'ar_qa' | 'ro_ro' | 'ru_ru' | 'fr_rw' | 'ar_sa' | 'fr_sn' | 'sr_rs' | 'en_sc' | 'en_sl' | 'zh_sg' | 'sk_sk' | 'sl_si' | 'en_sb' | 'so_so' | 'en_za' | 'ko_kr' | 'es_es' | 'si_lk' | 'sv_se' | 'de_ch' | 'zh_tw' | 'tg_tj' | 'sw_tz' | 'th_th' | 'en_tk' | 'to_to' | 'zh_tt' | 'ar_tn' | 'tr_tr' | 'tk_tm' | 'lg_ug' | 'uk_ua' | 'ar_ae' | 'en_gb' | 'en_us' | 'es_uy' | 'uz_uz' | 'es_ve' | 'vi_vn' | 'en_vi' | 'ny_zm' | 'ny_zw' | 'my_mm', required: Search market as language_country (e.g. da_dk = Danish in Denmark, en_us = English in United States).

## Response `201`

201

- object: Newly registered domain and identifiers.
  - `global_domain_identifier` string, required
  - `domain` string, required
  - `global_company_identifier` string, required
  - `hl` string, required
  - `gl` string, required

## Other responses

- `400`: 400
- `401`: 401
- `404`: 404
- `429`: 429
- `500`: 500

---

[API](https://skmtc.dev/morningscore/apis/morningscore-api.md) · [All operations](https://skmtc.dev/morningscore/apis/morningscore-api/llms.txt) · [OpenAPI document](https://skmtc.dev/morningscore/apis/morningscore-api/revisions/c307cf2cbaa7?raw)