# Essential Contacts API API

> Essential Contacts API API on Apizie: 7 endpoints (Lists all contacts for the resource that are subscribed to the specified notification categories, including…, Lists the contacts that have been set on a resource., Adds a new contact for a resource., Gets a single contact., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/analytics:googleapis-essentialcontacts/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `analytics:googleapis-essentialcontacts`
- Category: Analytics
- Status: byok
- Source: https://cloud.google.com/essentialcontacts/docs/
- Page: https://apizie.tech/api/analytics/googleapis-essentialcontacts
- OpenAPI: https://apizie.tech/api/analytics/googleapis-essentialcontacts/openapi.json



## Endpoints

### Lists all contacts for the resource that are subscribed to the specified notification categories, including…
`GET https://apizie.tech/v1/analytics:googleapis-essentialcontacts/essentialcontacts-projects-contacts-compute` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| notificationCategories | string | no | The categories of notifications to compute contacts for. If ALL is included in this list, contacts subscribed to any notification category… |
| pageSize | integer | no | Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of `next_page_token` in… |
| pageToken | string | no | Optional. If present, retrieves the next batch of results from the preceding call to this method. `page_token` must be the value of… |
| parent | string | yes | Required. The name of the resource to compute contacts for. Format: organizations/{organization}, folders/{folder} or projects/{project}… |

### Lists the contacts that have been set on a resource.
`GET https://apizie.tech/v1/analytics:googleapis-essentialcontacts/essentialcontacts-projects-contacts-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of `next_page_token` in… |
| pageToken | string | no | Optional. If present, retrieves the next batch of results from the preceding call to this method. `page_token` must be the value of… |
| parent | string | yes | Required. The parent resource name. Format: organizations/{organization}, folders/{folder} or projects/{project} (where {project} is the… |

### Adds a new contact for a resource.
`POST https://apizie.tech/v1/analytics:googleapis-essentialcontacts/essentialcontacts-projects-contacts-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The resource to save this contact for. Format: organizations/{organization}, folders/{folder} or projects/{project} (where… |
| body | object | yes | JSON request body |

### Gets a single contact.
`GET https://apizie.tech/v1/analytics:googleapis-essentialcontacts/essentialcontacts-projects-contacts-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. The name of the contact to retrieve. Format: organizations/{organization}/contacts/{contact},… |

### Updates a contact. Note: A contact's email address cannot be changed.
`POST https://apizie.tech/v1/analytics:googleapis-essentialcontacts/essentialcontacts-projects-contacts-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Output only. The identifier for the contact. Format: {resource_type}/{resource_id}/contacts/{contact_id} |
| updateMask | string | no | Optional. The update mask applied to the resource. For the `FieldMask` definition, see… |
| body | object | yes | JSON request body |

### Deletes a contact.
`POST https://apizie.tech/v1/analytics:googleapis-essentialcontacts/essentialcontacts-projects-contacts-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. The name of the contact to delete. Format: organizations/{organization}/contacts/{contact}, folders/{folder}/contacts/{contact}… |

### Allows a contact admin to send a test message to contact to verify that it has been configured correctly.
`POST https://apizie.tech/v1/analytics:googleapis-essentialcontacts/essentialcontacts-projects-contacts-send-test-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| resource | string | yes | Required. The name of the resource to send the test message for. All contacts must either be set directly on this resource or inherited… |
| body | object | yes | JSON request body |

## Example
```
curl "https://apizie.tech/v1/analytics:googleapis-essentialcontacts/essentialcontacts-projects-contacts-compute" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Essential Contacts API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/analytics:googleapis-essentialcontacts/essentialcontacts-projects-contacts-compute with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Essential Contacts API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Essential Contacts API itself also needs your own key from googleapis.com.

### Can AI agents use the Essential Contacts API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key analytics:googleapis-essentialcontacts.

### What is the status of the Essential Contacts API API?
Needs your own provider key (bring your own key)