Skip to contentDevelopersPrezly website
Domains

Link Custom Newsroom Domain

Link a custom domain and receive the required DNS configuration.

Personal token scopes: sites:write. Your account must also have access to the requested data. Authentication

Use instructions returned for this newsroom rather than a hard-coded CNAME target. Linking can immediately activate a domain whose DNS already matches.

Read the guide

POST
/newsrooms/{newsroom_id}/domains

Personal access tokens: sites:write. Every listed scope is required; the token owner's permissions, feature availability and newsroom access still apply.

Authorization

API_key
headerAuthorizationBearer <token>

Bearer authentication using an integration API key, or a personal access token only where the operation explicitly supports it. Every listed personal-token scope is required; owner permissions and newsroom access still apply.

Path Parameters

newsroom_id*string

Newsroom UUID or ID

Length1 <= length

Request Body

application/json
  1. body
domain*string

Response Body

OK

application/json
  1. response
domain?
Example Request
curl -X POST 'https://api.prezly.com/v2/newsrooms/string/domains' \  -H 'Content-Type: application/json' \  -d '{  "domain": "string"}'
Example Response200
{  "domain": {    "domain_name": "string",    "type": "prezly",    "status": "active",    "instructions": [      {        "domain_name": "string",        "type": "cname",        "recommended_value": "string",        "is_valid": true      }    ]  }}