Method Details
HTTP Methods:
GET
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing
Required Scope:
Get the metadata for a domain by ID.
There's a new version of the HubSpot API
As of November 30, 2022, HubSpot API Keys are being deprecated and are no longer supported. Continued use of HubSpot API Keys is a security risk to your account and data. Your API Keys could be deactivated at any time after Nov. 30th, and we recommend that you migrate to Private Apps as soon as possible so you do not lose business-critical functionality.
HTTP Methods:
GET
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing
Required Scope:
Get the metadata for a domain by ID.
Required Parameters | How to use | Description |
---|---|---|
OAuth Access Token or API Key | Authorization: Bearer {token} header or hapikey={key} query parameter. |
Used to authenticate the request. Please see this page for more details about authentication. |
domain_id | Used in the request URL | Unique identifier for a particular domain |
Hit this URL with a HTTP method of GET http://api.hubapi.com/cos-domains/v1/domains/101304?hapikey=demo
Parameter name | Type | Description |
---|---|---|
created | long | When the domain was first created, in milliseconds since the epoch |
domain | string | The actual domain or subdomain |
id | string | The unique id of the domain |
is_any_primary | string | True if this domain is primary for any category |
is_dns_correct | string | True if DNS for this domain is optimally configured for use with HubSpot |
is_legacy_domain | string | True is this domain is setup for use with the classic CMS |
is_resolving | string | True if this domain is pointing to HubSpot servers |
manually_marked_as_resolving | string | True if a user manually marked this domain as resolving. This is needed when their is some unique setup or proxy server involved, and the COS can not automatically detect if the domain is properly resolving |
primary_blog_post | string | True if this domain is primary for COS blog posts |
primary_email | string | True if this domain is primary for viewing emails as web page |
primary_landing_page | string | True if this domain is primary for COS landing pages |
primary_legacy_page | string | True if this domain is primary for the classic CMS |
primary_site_page | string | True if this domain is primary for COS site pages |
secondary_to_domain | string | The name of the domain that this domain redirects to. Only set for non-primary domains |
updated | long | When the domain was last updated, in milliseconds since the epoch |