---
title: "Create Twitter User Profile Monitor"
method: POST
path: "/monitors/user-profile"
tags: ["Monitoring API"]
---

# Create Twitter User Profile Monitor

`POST /monitors/user-profile`

Creates a new monitor to receive alerts when the target Twitter user changes their profile. Changes in any of the following user profile properties will trigger an event: name, screen_name, location, url, description, profile_banner_url, profile_image_url_https

## Request body

- union
  - object
    - `user_id` string, required — User ID of the target user. Required if user_screen_name not provided.
    - `user_screen_name` string — Username of the target user without @. Required if user_id not provided.
    - `webhook_url` string, uri — Monitor-specific webhook URL that will override your global webhook URL. Not required.
  - object
    - `user_id` string — User ID of the target user. Required if user_screen_name not provided.
    - `user_screen_name` string, required — Username of the target user without @. Required if user_id not provided.
    - `webhook_url` string, uri — Monitor-specific webhook URL that will override your global webhook URL. Not required.

## Response `200`

Monitor created successfully

- object
  - `status` string
  - `data` Monitor — Represents a monitor configuration
    - `id` string, required — Unique identifier for the monitor
    - `created_at` string, date-time, required — The UTC datetime when the monitor was created
    - `monitor_type` 'user_tweets' | 'user_following' | 'user_profile' | 'search_pump_fun', required — Type of monitor
    - `webhook_url` string, uri, nullable — Monitor-specific webhook URL that overrides the global webhook URL, if set
    - `parameters` object, required — Configuration parameters specific to the type of monitor

## Other responses

- `402` — Payment required - not enough credits to perform this request
- `422` — Validation failed (e.g. user not found)
- `500` — API internal error

---

[API](https://skmtc.dev/socialdata-api/apis/socialdata-api-reference.md) · [All operations](https://skmtc.dev/socialdata-api/apis/socialdata-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/socialdata-api/socialdata-api-reference/revisions/a898522f71ac/schema)