INinstantly
Lead

Bulk assign leads to organization users

Changed on

Bulk assign leads to organization users

post/api/v2/leads/bulk-assign

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/leads/bulk-assign
  • Auth
    HTTP bearer

Request body

searchstring

The search query to filter leads by.

filter'FILTER_VAL_CONTACTED' | 'FILTER_VAL_NOT_CONTACTED' | 'FILTER_VAL_COMPLETED' | 'FILTER_VAL_UNSUBSCRIBED' | 'FILTER_VAL_ACTIVE' | 'FILTER_LEAD_INTERESTED' | 'FILTER_LEAD_NOT_INTERESTED' | 'FILTER_LEAD_MEETING_BOOKED' | 'FILTER_LEAD_MEETING_COMPLETED' | 'FILTER_LEAD_CLOSED' | 'FILTER_LEAD_OUT_OF_OFFICE' | 'FILTER_LEAD_WRONG_PERSON' | 'FILTER_LEAD_LOST' | 'FILTER_LEAD_NO_SHOW' | 'FILTER_LEAD_CUSTOM_LABEL_POSITIVE' | 'FILTER_LEAD_CUSTOM_LABEL_NEGATIVE' | 'FILTER_VAL_BOUNCED' | 'FILTER_VAL_SKIPPED' | 'FILTER_VAL_RISKY' | 'FILTER_VAL_INVALID' | 'FILTER_VAL_VALID' | 'FILTER_VAL_CATCH_ALL' | 'FILTER_VAL_NOT_VERIFIED' | 'FILTER_VAL_IN_SUBSEQUENCE' | 'FILTER_VAL_OPENED_NO_REPLY' | 'FILTER_VAL_COMPLETED_NO_REPLY' | 'FILTER_VAL_NO_OPENS' | 'FILTER_VAL_REPLIED' | 'FILTER_VAL_LINK_CLICKED'

The filter to apply to the leads.

campaignstring uuid

The ID of the campaign to filter leads by.

list_idstring uuid

The ID of the list to filter leads by.

in_campaignboolean

Whether the leads are in the campaign.

in_listboolean

Whether the leads are in the list.

organization_user_idsstring[] required
smart_view_idstring uuid

The ID of the smart view to filter leads by.

idsstring[]

The IDs of the leads to filter by.

limitinteger

The limit of the number of leads to return.

assigned_tostring uuid

Filter leads by their current owner (the user they are currently assigned to).

has_clauseboolean

Whether this endpoint should list data based on the filters currently applied in the web app.

Example request

{
  "search": "test",
  "filter": "FILTER_LEAD_CLOSED",
  "campaign": "01a19e6f-8db5-77d2-bda4-f2001e92dd62",
  "list_id": "01a19e6f-8db5-77d2-bda4-f2016ac584e2",
  "in_campaign": true,
  "in_list": true,
  "organization_user_ids": [
    "01a19e6f-8db5-77d2-bda4-f2020c88856c"
  ],
  "smart_view_id": "01a19e6f-8db5-77d2-bda4-f2038b2fb8a4",
  "ids": [
    "01a19e6f-8db5-77d2-bda4-f204a6bc34f4"
  ],
  "limit": 10,
  "queries": [
    {
      "actionType": "email-open",
      "values": {
        "occurrence-days": 5,
        "occurrence-count": {
          "condition": "more",
          "count": 5
        },
        "lead-status": {
          "status": 5,
          "condition": "is"
        }
      }
    }
  ],
  "assigned_to": "01a19e6f-8db5-77d2-bda4-f205a2fd6d49",
  "has_clause": true
}

Response

Default Response

statusstring
messagestring

Example response

{
  "status": "accepted",
  "message": "Your request will be processed in a background job"
}

Changes

  • c781051105a8Revision changes
    • info

      added the new FILTER_VAL_CATCH_ALL enum value to the request property

    • info

      added the new FILTER_VAL_NOT_VERIFIED enum value to the request property