Update or View Contact

Update one contact by its Apollo id.

PATCH https://api.aisa.one/apis/v1/apollo/contacts/{contact_id}

Update or View Contact

cURL

curl --request PATCH \
  --url https://api.aisa.one/apis/v1/apollo/contacts/{contact_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": "<string>",
  "contact_stage_id": "<string>",
  "corporate_phone": "<string>",
  "direct_phone": "<string>",
  "email": "<string>",
  "first_name": "<string>",
  "home_phone": "<string>",
  "label_names": [
    "<string>"
  ],
  "last_name": "<string>",
  "mobile_phone": "<string>",
  "organization_name": "<string>",
  "other_phone": "<string>",
  "present_raw_address": "<string>",
  "title": "<string>",
  "typed_custom_fields": {
    "60c39ed82bd02f01154c470a": "2025-08-07"
  },
  "website_url": "<string>"
}
'

200

{
  "contact": {},
  "contact.account_id": "<string>",
  "contact.email": "<string>",
  "contact.first_name": "<string>",
  "contact.id": "<string>",
  "contact.last_name": "<string>",
  "contact.organization_name": "<string>",
  "contact.owner_id": "<string>",
  "contact.present_raw_address": "<string>",
  "contact.title": "<string>"
}

Update one contact by its Apollo id. Send only the fields you intend to change. Stage fields expect an id from get_apollo_contact_stages. Writes land in the AIsa workspace, which every caller shares: the record becomes visible and editable by others, and there is no per-caller isolation.

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.

Set this endpoint up in your agent →

Request contract

• Method and path: PATCH /apis/v1/apollo/contacts/{contact_id}
• Availability: enabled
• Request URL template: https://api.aisa.one/apis/v1/apollo/contacts/{contact_id}
• contact_id: path; required
• Runtime facts: 9ab7612cf2d53be794cbf1d65d4a257f986ac6783e53c7c3a5d868e4593061c3

Complete OpenAPI definition

Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "patch_apollo_contacts_contact_id",
  "method": "PATCH",
  "path": "/apis/v1/apollo/contacts/{contact_id}",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "description": "Contact ID",
      "in": "path",
      "name": "contact_id",
      "required": true,
      "schema": {
        "type": "string"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "properties": {
            "account_id": {
              "description": "Update the account ID. Example: `63f53afe4ceeca00016bdd2f`",
              "type": "string"
            },
            "contact_stage_id": {
              "description": "Update the contact stage ID. Example: `6095a710bd01d100a506d4af`",
              "type": "string"
            },
            "corporate_phone": {
              "description": "Work/office phone.",
              "type": "string"
            },
            "direct_phone": {
              "description": "Primary phone.",
              "type": "string"
            },
            "email": {
              "description": "Update the contact email. Example: `[e-mail]`",
              "type": "string"
            },
            "first_name": {
              "description": "Update the contact's first name. Example: `Tim`",
              "type": "string"
            },
            "home_phone": {
              "description": "Home phone.",
              "type": "string"
            },
            "label_names": {
              "description": "Replace lists this contact belongs to. (Passing new values will overwrite existing lists.)",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "last_name": {
              "description": "Update the contact's last name. Example: `Zheng`",
              "type": "string"
            },
            "mobile_phone": {
              "description": "Mobile phone.",
              "type": "string"
            },
            "organization_name": {
              "description": "Update the employer (company) name. Example: `apollo`",
              "type": "string"
            },
            "other_phone": {
              "description": "Alternate phone.",
              "type": "string"
            },
            "present_raw_address": {
              "description": "Update location (city/state/country). Example: `Atlanta, United States`",
              "type": "string"
            },
            "title": {
              "description": "Update the job title. Example: `senior research analyst`",
              "type": "string"
            },
            "typed_custom_fields": {
              "additionalProperties": {
                "type": "string"
              },
              "description": "Add information to <a href=\"https://knowledge.apollo.io/hc/en-us/articles/4412498825869-Create-Custom-Contact-Fields\" target=\"_blank\">custom fields</a> in Apollo. <br><br><b>Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.</b> <br><br>To utilize this parameter successfully, call the <a href=\"https://docs.apollo.io/reference/get-a-list-of-all-custom-fields\">get a list of all custom fields</a> endpoint and identify the `id` value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying `id` value for the picklist entry that you want to use as the input value. <br><br><b>Example</b>: When the <a href=\"https://docs.apollo.io/reference/get-a-list-of-all-custom-fields\">get a list of all custom fields</a> endpoint returns an `id` of field: \n * `\"60c39ed82bd02f01154c470a\"` (datetime) \n \n\n then the value passed should be: \n\n `{\"60c39ed82bd02f01154c470a\": \"2025-08-07\"}`",
              "example": {
                "60c39ed82bd02f01154c470a": "2025-08-07"
              },
              "type": "object"
            },
            "website_url": {
              "description": "Update the employer website URL. Example: `https://www.apollo.io/`",
              "type": "string"
            }
          },
          "type": "object"
        }
      }
    },
    "required": true
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "fixed_success",
    "customer_pricing": "fixed_success",
    "default_request_estimate_usd": 0.012,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

• Default request reference estimate (USD): 0.012
• Cost contract: fixed_success
• Settlement evidence source: request_snapshot

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

contact_id · string · required

Contact ID

Body

application/json

account_id · string

Update the account ID. Example: 63f53afe4ceeca00016bdd2f

contact_stage_id · string

Update the contact stage ID. Example: 6095a710bd01d100a506d4af

corporate_phone · string

Work/office phone.

direct_phone · string

Primary phone.

email · string

Update the contact email. Example: [e-mail]

first_name · string

Update the contact's first name. Example: Tim

home_phone · string

Home phone.

label_names · string[]

Replace lists this contact belongs to. (Passing new values will overwrite existing lists.)

last_name · string

Update the contact's last name. Example: Zheng

mobile_phone · string

Mobile phone.

organization_name · string

Update the employer (company) name. Example: apollo

other_phone · string

Alternate phone.

present_raw_address · string

Update location (city/state/country). Example: Atlanta, United States

title · string

Update the job title. Example: senior research analyst

typed_custom_fields · object

Add information to custom fields in Apollo.

Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.

To utilize this parameter successfully, call the get a list of all custom fields endpoint and identify the id value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying id value for the picklist entry that you want to use as the input value.

Example: When the get a list of all custom fields endpoint returns an id of field:

• "60c39ed82bd02f01154c470a" (datetime)

then the value passed should be:

{"60c39ed82bd02f01154c470a": "2025-08-07"}

Show child attributes

Example:

{ "60c39ed82bd02f01154c470a": "2025-08-07" }

website_url · string

Update the employer website URL. Example: https://www.apollo.io/

Response

200

application/json

Successful response

contact · object

Updated contact

contact.account_id · string

Account ID

contact.email · string

Email

contact.first_name · string

First name

contact.id · string

Contact ID

contact.last_name · string

Last name

contact.organization_name · string

Organization name

contact.owner_id · string

Owner ID

contact.present_raw_address · string

Raw address

contact.title · string

Title