Bulk Create Radars

curl --request POST \
  --url https://api.tamradar.com/v1/radars/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "webhook_url": "https://your-domain.com/webhooks/tamradar",
  "radars": [
    {
      "domain": "stripe.com",
      "radar_type": "company_job_openings",
      "departments": [
        "Engineering"
      ],
      "custom_fields": {
        "crm_account_id": "acc_001"
      }
    },
    {
      "domain": "stripe.com",
      "radar_type": "contact_job_changes",
      "profile_url": "https://www.linkedin.com/in/janedoe",
      "custom_fields": {
        "contact_id": "con_001"
      }
    },
    {
      "radar_type": "industry_mentions",
      "keyword": "zero trust security",
      "countries": [
        "US"
      ]
    }
  ]
}
'

{
  "status": "success",
  "code": 202,
  "message": "Bulk submission accepted — radars are being created asynchronously",
  "bulk_id": "5f9da22e-4778-427c-b7e4-dab2a8d9d709",
  "summary": {
    "total": 3
  },
  "timestamp": "2026-05-24T18:22:01.000Z"
}

{
  "status": "error",
  "code": 400,
  "message": "Invalid request body",
  "errors": [
    {
      "field": "webhook_url",
      "reason": "webhook_url is required for async bulk requests"
    }
  ],
  "timestamp": "2026-05-24T18:22:01.000Z"
}

{
  "status": "error",
  "code": 400,
  "message": "<string>",
  "errors": [
    {
      "field": "<string>",
      "reason": "<string>",
      "conflicting_radar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "timestamp": "2023-11-07T05:31:56Z",
  "error_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "status": "error",
  "code": 429,
  "message": "Rate limit exceeded — wait and retry.",
  "errors": [
    {
      "field": "rate_limit",
      "reason": "minute"
    }
  ],
  "timestamp": "2026-05-24T18:22:01.000Z"
}

{
  "status": "error",
  "code": 400,
  "message": "<string>",
  "errors": [
    {
      "field": "<string>",
      "reason": "<string>",
      "conflicting_radar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "timestamp": "2023-11-07T05:31:56Z",
  "error_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

POST

radars

bulk

curl --request POST \
  --url https://api.tamradar.com/v1/radars/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "webhook_url": "https://your-domain.com/webhooks/tamradar",
  "radars": [
    {
      "domain": "stripe.com",
      "radar_type": "company_job_openings",
      "departments": [
        "Engineering"
      ],
      "custom_fields": {
        "crm_account_id": "acc_001"
      }
    },
    {
      "domain": "stripe.com",
      "radar_type": "contact_job_changes",
      "profile_url": "https://www.linkedin.com/in/janedoe",
      "custom_fields": {
        "contact_id": "con_001"
      }
    },
    {
      "radar_type": "industry_mentions",
      "keyword": "zero trust security",
      "countries": [
        "US"
      ]
    }
  ]
}
'

{
  "status": "success",
  "code": 202,
  "message": "Bulk submission accepted — radars are being created asynchronously",
  "bulk_id": "5f9da22e-4778-427c-b7e4-dab2a8d9d709",
  "summary": {
    "total": 3
  },
  "timestamp": "2026-05-24T18:22:01.000Z"
}

{
  "status": "error",
  "code": 400,
  "message": "Invalid request body",
  "errors": [
    {
      "field": "webhook_url",
      "reason": "webhook_url is required for async bulk requests"
    }
  ],
  "timestamp": "2026-05-24T18:22:01.000Z"
}

{
  "status": "error",
  "code": 400,
  "message": "<string>",
  "errors": [
    {
      "field": "<string>",
      "reason": "<string>",
      "conflicting_radar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "timestamp": "2023-11-07T05:31:56Z",
  "error_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "status": "error",
  "code": 429,
  "message": "Rate limit exceeded — wait and retry.",
  "errors": [
    {
      "field": "rate_limit",
      "reason": "minute"
    }
  ],
  "timestamp": "2026-05-24T18:22:01.000Z"
}

{
  "status": "error",
  "code": 400,
  "message": "<string>",
  "errors": [
    {
      "field": "<string>",
      "reason": "<string>",
      "conflicting_radar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "timestamp": "2023-11-07T05:31:56Z",
  "error_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

The bulk_completed webhook carries the full per-item result array. At 1,000 items with rich custom_fields or filter data, the payload can approach 1–2 MB — ensure your receiver can handle it. Alternatively, use GET /v1/radars/bulk/{bulk_id} to fetch results on demand.

Authorizations

x-api-key

string

header

required

Body

application/json

radars

object[]

required

Array of radar payloads. Each item uses the same body structure as single radar creation (POST /v1/radars): include radar_type plus the matching fields for that radar (for example domain/profile_url/keyword, filters, custom_fields). Item-level validation runs asynchronously after the request is accepted.

Required array length: 1 - 1000 elements

Show child attributes

webhook_url

string<uri>

Optional webhook endpoint that receives async item results and the final bulk_completed event. Omit for poll-only mode and track the batch via GET /v1/radars/bulk/{bulk_id}. Omit the field entirely to disable webhooks — an explicit null is rejected with 400.

Maximum string length: 2048

Example:

"https://your-domain.com/webhooks/tamradar"

Response

Bulk submission accepted and queued for async processing

status

enum<string>

required

Available options:

success

code

enum<integer>

required

Available options:

202

message

string

required

bulk_id

string<uuid>

required

summary

object

required

Show child attributes

timestamp

string<date-time>

required

Introduction / Overview

Getting Started

Core Guides

Agentic Setup

API Reference

Bulk

Webhooks

Authorizations

Body

Response