BlockListEntry

Bulk create block list entry

Requires one of the following scopes: block_list_entries:create, block_list_entries:all, all:create, all:all

post/api/v2/block-lists-entries/bulk-create

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/block-lists-entries/bulk-create
  • Auth
    HTTP bearer

Request body

bl_valuesstring[] required

List of domains or emails to block

Example request

{
  "bl_values": [
    "example.com",
    "user@example.com"
  ]
}

Response

List of created Block List Entry

valid_countnumber required

Number of valid entries

invalid_countnumber required

Number of invalid entries

Example response

{
  "items": [
    {
      "id": "01a19e6f-509a-7172-9a36-040da2e6dd9f",
      "timestamp_created": "2026-11-02T22:44:17.690Z",
      "organization_id": "01a19e6f-509a-7172-9a36-040e08395cbe",
      "bl_value": "example.com",
      "is_domain": true
    }
  ],
  "valid_count": 1
}

Changes

No recorded changes to this operation across all 6 revisions of this API.