Add Google Search Console site

Add a domain as a Google Search Console property.

← All Google Search Console endpoints · Capability overview

POST/v1/google-search-console/sites

https://api.vee3.io/v1/google-search-console/sites

10 tokens

Add a domain as a Google Search Console property.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

google-search-console.add_site

Parameters1 field

site_urlstringRequired

Domain or property to add. The user or agent passes a hostname (example.com), a domain property (sc-domain:example.com), or a URL (https://example.com/).

Response8 fields

site_urlstring

Normalized Search Console domain property URL.

domain_namestring

Normalized domain name for the property.

statusstring

added, already_added, pending_verification (wait and retry), or needs_verification (add the DNS TXT record, then retry).

is_managedboolean

True when the domain is a Vee3-managed domain for this account.

messagestring

What happened and what the user or agent should do next.

dns_host_namestring

DNS host to create when status is needs_verification. Always @.

dns_record_typestring

DNS record type to create when status is needs_verification. Always TXT.

dns_tokenstring

DNS TXT record value to create when status is needs_verification.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, google_search_console_connection_required, google_search_console_connection_refresh_failed, google_search_console_connection_scopes_insufficient, google_search_console_upstream_error, google_search_console_site_not_found, google_search_console_rate_limited, dns_not_using_namecheap

Example request

Python

import requests

url = "https://api.vee3.io/v1/google-search-console/sites"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "site_url": "example.com"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses3 examples

200Vee3-managed domain added and verified.

managed_site_added.json

{
  "site_url": "sc-domain:example.com",
  "domain_name": "example.com",
  "status": "added",
  "is_managed": true,
  "message": "This Vee3-managed domain is now added to Google Search Console."
}

200Managed domain is still propagating DNS verification.

pending_verification.json

{
  "site_url": "sc-domain:example.com",
  "domain_name": "example.com",
  "status": "pending_verification",
  "is_managed": true,
  "message": "Google is still verifying this Vee3-managed domain. Wait a short time, then call google-search-console.add_site again with the same site_url."
}

200Unmanaged domain needs a DNS TXT record before it can be added.

needs_verification.json

{
  "site_url": "sc-domain:other-example.com",
  "domain_name": "other-example.com",
  "status": "needs_verification",
  "is_managed": false,
  "message": "This domain is not managed by Vee3. Create a DNS TXT record on the apex host @ with the token in dns_token. Wait for DNS to update, then call google-search-console.add_site again with the same site_url.",
  "dns_host_name": "@",
  "dns_record_type": "TXT",
  "dns_token": "google-site-verification=abc123"
}