---
title: "Enqueue a bulk entity creation task"
method: POST
path: "/entities/create/enqueue"
tags: ["Monitoring: Entity Creation"]
---

# Enqueue a bulk entity creation task

`POST /entities/create/enqueue`

This endpoint will asynchronously add one or more entities to your monitored entity population. It is recommended that you use this endpoint when adding more than one entity. You will receive a webhook event when the entity creation job completes.

## Request body

- RequestEntitiesUploadRequestPublic
  - `entityGroupIDs` integer[], nullable, required
  - `filterSetID` integer, required
  - `searches` SigmaidBasicSearchParams[], nullable
    - `aliases` string[], nullable — Secondary names to perform a search on
    - `countries` string[], nullable — ISO 3166-1 alpha-2
    - `customFields` SigmaidCustomEntityField[], nullable — Optional. A list of custom fields to be associated with the entity for cross-referencing or disambiguation in alerts and monitoring. Does not affecting risk or matching logic. Each field must have a unique key.
      - `key` string
      - `value` string
    - `customerKey` string — Optional. A user-provided identifier that will be returned in alerts and monitoring. Any format.
    - `dob` string, nullable — Birth or foundation date. YYYY, YYYY-MM, YYYY-MM-DD, YYYY/MM or YYYY/MM/DD format.
    - `entityName` string, required — The primary name of the search
    - `entityType` 'person' | 'company' | 'aircraft' | 'vessel', nullable

## Response `200`

OK

- ResponseBulkEntityUploadResponse
  - `taskID` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Too Many Requests
- `500` — Internal Server Error

---

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