Add Google Search Console site

POST example.com and the Search Console API adds it as a property. A domain Vee3 already manages is verified in that request. If Google still wants a DNS record, the response includes the record to create, and you send the domain again once it exists.

Agents send that add from MCP. The domain then shows up in List Google Search Console sites.

POST/v1/google-search-console/sites

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

10 tokens

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 (create the DNS record in this response, 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. @ for TXT, or the Google CNAME host for domain properties that cannot use an apex TXT record.

dns_record_typestring

DNS record type to create when status is needs_verification. TXT or CNAME.

dns_tokenstring

DNS 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"
}