Skip to main content
POST
/
catchAll
/
monitors
/
create
Create monitor
curl --request POST \
  --url https://catchall.newscatcherapi.com/catchAll/monitors/create \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "reference_job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "schedule": "every day at 12 PM UTC",
  "webhook": {
    "url": "<string>",
    "method": "POST",
    "headers": {},
    "params": {},
    "auth": [
      "<string>"
    ]
  }
}'
{
  "monitor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "Monitor Created Successfully"
}

Authorizations

​
x-api-key
string
header
required

API key for authentication.

Body

application/json
​
reference_job_id
string<uuid>
required

Job ID to use as template for scheduled runs.

​
schedule
string
required

Natural language schedule description. Examples:

  • "every day at 12 PM UTC"
  • "every Monday at 9 AM EST"
  • "every 6 hours"

Warning: Schedule validation is limited. Test carefully before production.

Example:

"every day at 12 PM UTC"

​
webhook
object

Optional webhook to receive notifications when jobs complete.

Response

Monitor created successfully

​
monitor_id
string<uuid>

Monitor ID if successful, null if error.

​
status
string

Creation status or error message

Example:

"Monitor Created Successfully"