---
title: "Add contacts to a job change monitor"
method: POST
path: "/job-change-monitors/{id}/contacts"
tags: ["Monitoring"]
---

# Add contacts to a job change monitor

`POST /job-change-monitors/{id}/contacts`

## Request

- Base URL: `https://app.1lookup.io/api/v1`
- URL: `https://app.1lookup.io/api/v1/job-change-monitors/{id}/contacts`
- Auth: HTTP bearer

Adds public professional profile URLs to a monitor. Duplicates and invalid entries are reported, not added. Up to 500 contacts per monitor. Free.

## Path parameters

- `id` string, required

## Request body

- object
  - `contacts` union[], required: Profile URLs, as strings or as objects with an optional label.
    - union
      - string
      - object
        - `profile_url` string, required
        - `label` string

## Response `200`

Contacts added.

- object
  - `success` true, required
  - `data` object, required
    - `added` integer, required
    - `duplicates` integer, required
    - `invalid` object[], required: Entries that were refused, with the reason.
      - `input` string
      - `error` string
    - `total` integer, required: Entries on the monitor now.

## Other responses

- `400`: `INVALID_REQUEST`: The body is not valid JSON; `INVALID_INPUT`: The input does not match the expected format
- `401`: `UNAUTHORIZED`: Invalid or missing API key
- `403`: `UPGRADE_REQUIRED`: The account has no paid plan, and API access needs one. Upgrade at https://app.1lookup.io/billing?tab=plan; `INSUFFICIENT_SCOPE`: The call was signed with an AI connector (MCP) sign-in, which can only reach /phone, /email, /ip and /account. Use an API key
- `404`: `NOT_FOUND`: Resource not found
- `409`: `LIMIT_REACHED`: An account or monitor limit was reached (active monitors, or numbers or contacts per monitor)
- `429`: `RATE_LIMIT_EXCEEDED`: Too many requests
- `500`: `INTERNAL_ERROR`: Internal server error
- `503`: `SERVICE_UNAVAILABLE`: The lookup service, or the API key check, is temporarily unavailable. Nothing was charged; retry after `Retry-After` seconds

---

[API](https://skmtc.dev/1lookup/apis/1lookup-api.md) · [All operations](https://skmtc.dev/1lookup/apis/1lookup-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1lookup/apis/1lookup-api/revisions/57b6d8ba04ac?raw)