Skip to content
All tools

create_contact

Contacts · Windows

Effect: write (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

Windows

Purpose

Creates a contact in Microsoft Outlook's Contacts on Windows (its default Contacts folder): name, company, phones, emails and a photo from a local image. Needs a first name, a last name or a company. Returns the new contact_id. To add it to a group use add_contact_to_group. Notes are not written, as on the Mac.

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Full input schema — Windows
{
  "properties": {
    "company": {
      "description": "Company or organization.",
      "type": "string"
    },
    "confirm": {
      "description": "Ignored; kept for older clients.",
      "type": "boolean"
    },
    "emails": {
      "description": "Email addresses, as a JSON array or comma-separated.",
      "type": "string"
    },
    "first_name": {
      "description": "Given name.",
      "type": "string"
    },
    "last_name": {
      "description": "Family name.",
      "type": "string"
    },
    "phones": {
      "description": "Phone numbers, as a JSON array or comma-separated (with the country code, e.g. +54 11 5555 0001).",
      "type": "string"
    },
    "photo_path": {
      "description": "Absolute path of a local image (PNG, JPEG, GIF or BMP, up to 10 MB) to use as the contact's photo.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "company": "Example Co",
  "confirm": false,
  "emails": "alex@example.com",
  "first_name": "Alex",
  "last_name": "Rivera",
  "phones": "+1 555 0100"
}