Skip to main content
Glama
debanjanbasu

grr

by debanjanbasu
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Rust
Local

people.people.batchCreateContacts

Create multiple new contacts in one batch request and return the created contact details for each item; useful for bulk contact creation.

Instructions

Create a batch of new contacts and return the PersonResponses for the newly Mutate requests for the same user should be sent sequentially to avoid increased latency and failures [HTTP POST] — creates or triggers a change; refused under --readonly safety profiles. Returns the API's response resource as JSON — request body is a JSON BatchCreateContactsRequest object accepting contacts, readMask, sources; pass it via params or whole via body_file Siblings over the same resource: batchDeleteContacts, batchUpdateContacts, createContact, deleteContact, deleteContactPhoto, get, getBatchGet, listDirectoryPeople, searchContacts, searchDirectoryPeople, updateContact, updateContactPhoto.

Input Schema

NameRequiredDescriptionDefault
queryNoExtra KEY=VALUE query pairs for endpoints whose parameters Discovery does not describe.
paramsNoParameter map merged into the request; typed parameters win.
dry_runNoReturn the request that would be sent, without sending it.
body_fileNoRead the request body from this file ('-' for stdin) instead of building one from the parameters. The body is a JSON BatchCreateContactsRequest object.
request_bodyNoRequest body of type BatchCreateContactsRequest: pass it via `params` (merged into the built body) or whole via `body_file`.

Output Schema

NameRequiredDescriptionDefault
createdPeopleNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / body_file / description
      Previous value: -"Read the request body from this file ('-' for stdin) instead of building one from the parameters."New value: +"Read the request body from this file ('-' for stdin) instead of building one from the parameters. The body is a JSON BatchCreateContactsRequest object."
    • addedInput schema / properties / request_body
      Added value: +{
+  "description": "Request body of type BatchCreateContactsRequest: pass it via `params` (merged into the built body) or whole via `body_file`.",
+  "properties": {
+    "contacts": {
+      "items": {
+        "properties": {
+          "contactPerson": {
+            "properties": {
+              "addresses": {
+                "items": {
+                  "properties": {
+                    "city": {
+                      "type": "string"
+                    },
+                    "country": {
+                      "type": "string"
+                    },
+                    "countryCode": {
+                      "type": "string"
+                    },
+                    "extendedAddress": {
+                      "type": "string"
+                    },
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "formattedValue": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "poBox": {
+                      "type": "string"
+                    },
+                    "postalCode": {
+                      "type": "string"
+                    },
+                    "region": {
+                      "type": "string"
+                    },
+                    "streetAddress": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "ageRange": {
+                "enum": [
+                  "AGE_RANGE_UNSPECIFIED",
+                  "LESS_THAN_EIGHTEEN",
+                  "EIGHTEEN_TO_TWENTY",
+                  "TWENTY_ONE_OR_OLDER"
+                ],
+                "type": "string"
+              },
+              "ageRanges": {
+                "items": {
+                  "properties": {
+                    "ageRange": {
+                      "enum": [
+                        "AGE_RANGE_UNSPECIFIED",
+                        "LESS_THAN_EIGHTEEN",
+                        "EIGHTEEN_TO_TWENTY",
+                        "TWENTY_ONE_OR_OLDER"
+                      ],
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "biographies": {
+                "items": {
+                  "properties": {
+                    "contentType": {
+                      "enum": [
+                        "CONTENT_TYPE_UNSPECIFIED",
+                        "TEXT_PLAIN",
+                        "TEXT_HTML"
+                      ],
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "birthdays": {
+                "items": {
+                  "properties": {
+                    "date": {
+                      "type": "object"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "text": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "braggingRights": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "calendarUrls": {
+                "items": {
+                  "properties": {
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "clientData": {
+                "items": {
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "coverPhotos": {
+                "items": {
+                  "properties": {
+                    "default": {
+                      "type": "boolean"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "url": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "emailAddresses": {
+                "items": {
+                  "properties": {
+                    "displayName": {
+                      "type": "string"
+                    },
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "etag": {
+                "type": "string"
+              },
+              "events": {
+                "items": {
+                  "properties": {
+                    "date": {
+                      "type": "object"
+                    },
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "externalIds": {
+                "items": {
+                  "properties": {
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "fileAses": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "genders": {
+                "items": {
+                  "properties": {
+                    "addressMeAs": {
+                      "type": "string"
+                    },
+                    "formattedValue": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "imClients": {
+                "items": {
+                  "properties": {
+                    "formattedProtocol": {
+                      "type": "string"
+                    },
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "protocol": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "username": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "interests": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "locales": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "locations": {
+                "items": {
+                  "properties": {
+                    "buildingId": {
+                      "type": "string"
+                    },
+                    "current": {
+                      "type": "boolean"
+                    },
+                    "deskCode": {
+                      "type": "string"
+                    },
+                    "floor": {
+                      "type": "string"
+                    },
+                    "floorSection": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "memberships": {
+                "items": {
+                  "properties": {
+                    "contactGroupMembership": {
+                      "type": "object"
+                    },
+                    "domainMembership": {
+                      "type": "object"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "metadata": {
+                "properties": {
+                  "deleted": {
+                    "type": "boolean"
+                  },
+                  "linkedPeopleResourceNames": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "objectType": {
+                    "enum": [
+                      "OBJECT_TYPE_UNSPECIFIED",
+                      "PERSON",
+                      "PAGE"
+                    ],
+                    "type": "string"
+                  },
+                  "previousResourceNames": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "sources": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "miscKeywords": {
+                "items": {
+                  "properties": {
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "enum": [
+                        "TYPE_UNSPECIFIED",
+                        "OUTLOOK_BILLING_INFORMATION",
+                        "OUTLOOK_DIRECTORY_SERVER",
+                        "OUTLOOK_KEYWORD",
+                        "OUTLOOK_MILEAGE",
+                        "OUTLOOK_PRIORITY",
+                        "OUTLOOK_SENSITIVITY",
+                        "OUTLOOK_SUBJECT",
+                        "OUTLOOK_USER",
+                        "HOME",
+                        "WORK",
+                        "OTHER"
+                      ],
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "names": {
+                "items": {
+                  "properties": {
+                    "displayName": {
+                      "type": "string"
+                    },
+                    "displayNameLastFirst": {
+                      "type": "string"
+                    },
+                    "familyName": {
+                      "type": "string"
+                    },
+                    "givenName": {
+                      "type": "string"
+                    },
+                    "honorificPrefix": {
+                      "type": "string"
+                    },
+                    "honorificSuffix": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "middleName": {
+                      "type": "string"
+                    },
+                    "phoneticFamilyName": {
+                      "type": "string"
+                    },
+                    "phoneticFullName": {
+                      "type": "string"
+                    },
+                    "phoneticGivenName": {
+                      "type": "string"
+                    },
+                    "phoneticHonorificPrefix": {
+                      "type": "string"
+                    },
+                    "phoneticHonorificSuffix": {
+                      "type": "string"
+                    },
+                    "phoneticMiddleName": {
+                      "type": "string"
+                    },
+                    "unstructuredName": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "nicknames": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "enum": [
+                        "DEFAULT",
+                        "MAIDEN_NAME",
+                        "INITIALS",
+                        "GPLUS",
+                        "OTHER_NAME",
+                        "ALTERNATE_NAME",
+                        "SHORT_NAME"
+                      ],
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "occupations": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "organizations": {
+                "items": {
+                  "properties": {
+                    "costCenter": {
+                      "type": "string"
+                    },
+                    "current": {
+                      "type": "boolean"
+                    },
+                    "department": {
+                      "type": "string"
+                    },
+                    "domain": {
+                      "type": "string"
+                    },
+                    "endDate": {
+                      "type": "object"
+                    },
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "fullTimeEquivalentMillipercent": {
+                      "type": "integer"
+                    },
+                    "jobDescription": {
+                      "type": "string"
+                    },
+                    "location": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "phoneticName": {
+                      "type": "string"
+                    },
+                    "startDate": {
+                      "type": "object"
+                    },
+                    "symbol": {
+                      "type": "string"
+                    },
+                    "title": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "phoneNumbers": {
+                "items": {
+                  "properties": {
+                    "canonicalForm": {
+                      "type": "string"
+                    },
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "photos": {
+                "items": {
+                  "properties": {
+                    "default": {
+                      "type": "boolean"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "url": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "relations": {
+                "items": {
+                  "properties": {
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "person": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "relationshipInterests": {
+                "items": {
+                  "properties": {
+                    "formattedValue": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "relationshipStatuses": {
+                "items": {
+                  "properties": {
+                    "formattedValue": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "residences": {
+                "items": {
+                  "properties": {
+                    "current": {
+                      "type": "boolean"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "resourceName": {
+                "type": "string"
+              },
+              "sipAddresses": {
+                "items": {
+                  "properties": {
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "skills": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "taglines": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "urls": {
+                "items": {
+                  "properties": {
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "userDefined": {
+                "items": {
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "readMask": {
+      "type": "string"
+    },
+    "sources": {
+      "items": {
+        "enum": [
+          "READ_SOURCE_TYPE_UNSPECIFIED",
+          "READ_SOURCE_TYPE_PROFILE",
+          "READ_SOURCE_TYPE_CONTACT",
+          "READ_SOURCE_TYPE_DOMAIN_CONTACT",
+          "READ_SOURCE_TYPE_OTHER_CONTACT"
+        ],
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}
  2. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "properties": {
+    "createdPeople": {
+      "items": {
+        "properties": {
+          "httpStatusCode": {
+            "type": "integer"
+          },
+          "person": {
+            "properties": {
+              "addresses": {
+                "items": {
+                  "properties": {
+                    "city": {
+                      "type": "string"
+                    },
+                    "country": {
+                      "type": "string"
+                    },
+                    "countryCode": {
+                      "type": "string"
+                    },
+                    "extendedAddress": {
+                      "type": "string"
+                    },
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "formattedValue": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "poBox": {
+                      "type": "string"
+                    },
+                    "postalCode": {
+                      "type": "string"
+                    },
+                    "region": {
+                      "type": "string"
+                    },
+                    "streetAddress": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "ageRange": {
+                "enum": [
+                  "AGE_RANGE_UNSPECIFIED",
+                  "LESS_THAN_EIGHTEEN",
+                  "EIGHTEEN_TO_TWENTY",
+                  "TWENTY_ONE_OR_OLDER"
+                ],
+                "type": "string"
+              },
+              "ageRanges": {
+                "items": {
+                  "properties": {
+                    "ageRange": {
+                      "enum": [
+                        "AGE_RANGE_UNSPECIFIED",
+                        "LESS_THAN_EIGHTEEN",
+                        "EIGHTEEN_TO_TWENTY",
+                        "TWENTY_ONE_OR_OLDER"
+                      ],
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "biographies": {
+                "items": {
+                  "properties": {
+                    "contentType": {
+                      "enum": [
+                        "CONTENT_TYPE_UNSPECIFIED",
+                        "TEXT_PLAIN",
+                        "TEXT_HTML"
+                      ],
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "birthdays": {
+                "items": {
+                  "properties": {
+                    "date": {
+                      "type": "object"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "text": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "braggingRights": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "calendarUrls": {
+                "items": {
+                  "properties": {
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "clientData": {
+                "items": {
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "coverPhotos": {
+                "items": {
+                  "properties": {
+                    "default": {
+                      "type": "boolean"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "url": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "emailAddresses": {
+                "items": {
+                  "properties": {
+                    "displayName": {
+                      "type": "string"
+                    },
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "etag": {
+                "type": "string"
+              },
+              "events": {
+                "items": {
+                  "properties": {
+                    "date": {
+                      "type": "object"
+                    },
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "externalIds": {
+                "items": {
+                  "properties": {
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "fileAses": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "genders": {
+                "items": {
+                  "properties": {
+                    "addressMeAs": {
+                      "type": "string"
+                    },
+                    "formattedValue": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "imClients": {
+                "items": {
+                  "properties": {
+                    "formattedProtocol": {
+                      "type": "string"
+                    },
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "protocol": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "username": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "interests": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "locales": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "locations": {
+                "items": {
+                  "properties": {
+                    "buildingId": {
+                      "type": "string"
+                    },
+                    "current": {
+                      "type": "boolean"
+                    },
+                    "deskCode": {
+                      "type": "string"
+                    },
+                    "floor": {
+                      "type": "string"
+                    },
+                    "floorSection": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "memberships": {
+                "items": {
+                  "properties": {
+                    "contactGroupMembership": {
+                      "type": "object"
+                    },
+                    "domainMembership": {
+                      "type": "object"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "metadata": {
+                "properties": {
+                  "deleted": {
+                    "type": "boolean"
+                  },
+                  "linkedPeopleResourceNames": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "objectType": {
+                    "enum": [
+                      "OBJECT_TYPE_UNSPECIFIED",
+                      "PERSON",
+                      "PAGE"
+                    ],
+                    "type": "string"
+                  },
+                  "previousResourceNames": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "sources": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "miscKeywords": {
+                "items": {
+                  "properties": {
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "enum": [
+                        "TYPE_UNSPECIFIED",
+                        "OUTLOOK_BILLING_INFORMATION",
+                        "OUTLOOK_DIRECTORY_SERVER",
+                        "OUTLOOK_KEYWORD",
+                        "OUTLOOK_MILEAGE",
+                        "OUTLOOK_PRIORITY",
+                        "OUTLOOK_SENSITIVITY",
+                        "OUTLOOK_SUBJECT",
+                        "OUTLOOK_USER",
+                        "HOME",
+                        "WORK",
+                        "OTHER"
+                      ],
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "names": {
+                "items": {
+                  "properties": {
+                    "displayName": {
+                      "type": "string"
+                    },
+                    "displayNameLastFirst": {
+                      "type": "string"
+                    },
+                    "familyName": {
+                      "type": "string"
+                    },
+                    "givenName": {
+                      "type": "string"
+                    },
+                    "honorificPrefix": {
+                      "type": "string"
+                    },
+                    "honorificSuffix": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "middleName": {
+                      "type": "string"
+                    },
+                    "phoneticFamilyName": {
+                      "type": "string"
+                    },
+                    "phoneticFullName": {
+                      "type": "string"
+                    },
+                    "phoneticGivenName": {
+                      "type": "string"
+                    },
+                    "phoneticHonorificPrefix": {
+                      "type": "string"
+                    },
+                    "phoneticHonorificSuffix": {
+                      "type": "string"
+                    },
+                    "phoneticMiddleName": {
+                      "type": "string"
+                    },
+                    "unstructuredName": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "nicknames": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "enum": [
+                        "DEFAULT",
+                        "MAIDEN_NAME",
+                        "INITIALS",
+                        "GPLUS",
+                        "OTHER_NAME",
+                        "ALTERNATE_NAME",
+                        "SHORT_NAME"
+                      ],
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "occupations": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "organizations": {
+                "items": {
+                  "properties": {
+                    "costCenter": {
+                      "type": "string"
+                    },
+                    "current": {
+                      "type": "boolean"
+                    },
+                    "department": {
+                      "type": "string"
+                    },
+                    "domain": {
+                      "type": "string"
+                    },
+                    "endDate": {
+                      "type": "object"
+                    },
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "fullTimeEquivalentMillipercent": {
+                      "type": "integer"
+                    },
+                    "jobDescription": {
+                      "type": "string"
+                    },
+                    "location": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "phoneticName": {
+                      "type": "string"
+                    },
+                    "startDate": {
+                      "type": "object"
+                    },
+                    "symbol": {
+                      "type": "string"
+                    },
+                    "title": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "phoneNumbers": {
+                "items": {
+                  "properties": {
+                    "canonicalForm": {
+                      "type": "string"
+                    },
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "photos": {
+                "items": {
+                  "properties": {
+                    "default": {
+                      "type": "boolean"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "url": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "relations": {
+                "items": {
+                  "properties": {
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "person": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "relationshipInterests": {
+                "items": {
+                  "properties": {
+                    "formattedValue": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "relationshipStatuses": {
+                "items": {
+                  "properties": {
+                    "formattedValue": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "residences": {
+                "items": {
+                  "properties": {
+                    "current": {
+                      "type": "boolean"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "resourceName": {
+                "type": "string"
+              },
+              "sipAddresses": {
+                "items": {
+                  "properties": {
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "skills": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "taglines": {
+                "items": {
+                  "properties": {
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "urls": {
+                "items": {
+                  "properties": {
+                    "formattedType": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "userDefined": {
+                "items": {
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "metadata": {
+                      "type": "object"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          "requestedResourceName": {
+            "type": "string"
+          },
+          "status": {
+            "properties": {
+              "code": {
+                "type": "integer"
+              },
+              "details": {
+                "items": {
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "message": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}
  3. First observed

TDQS

A3.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden and does disclose several traits: HTTP POST, that it 'creates or triggers a change,' that it is refused under --readonly profiles, the sequential-call latency caveat, and that it returns the API's response resource as JSON. It lacks auth/permission requirements or partial-failure semantics, but the mutation and safety behavior are clearly conveyed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded, but the text is a run-on with a garbled truncated sentence ('for the newly Mutate requests') and a long redundant sibling enumeration appended in-line. The useful sequencing caveat is buried rather than clearly separated, hurting scannability.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values needn't be re-explained, and params are fully covered by the schema. The description adds the behavioral context a mutation tool needs with no annotations: mutation nature, readonly refusal, and sequential-call guidance. Auth/permission details are the only notable gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the schema already documents all five params richly. The description adds marginal value by explaining the request body is a JSON BatchCreateContactsRequest accepting contacts, readMask, sources, and how to pass it (via `params` merged or whole via `body_file`). Baseline 3 is appropriate since the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence states a clear verb+resource: 'Create a batch of new contacts and return the PersonResponses.' Combined with the explicit sibling list (batchDeleteContacts, batchUpdateContacts, createContact, etc.), an agent can tell this is the bulk-create variant over the People resource. The sentence is somewhat garbled where it reads 'the newly Mutate requests,' but the core action is unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It adds operational guidance – 'Mutate requests for the same user should be sent sequentially to avoid increased latency and failures' – and notes it is refused under --readonly safety profiles. However, it does not explicitly contrast when to use this over createContact (single) vs batchUpdateContacts, leaving the batch-vs-single routing implied rather than stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools