Skip to main content
POST
/
api
/
v2
/
leads
/
bulk-assign
Bulk assign leads to organization users
curl --request POST \
  --url https://api.instantly.ai/api/v2/leads/bulk-assign \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "organization_user_ids": [
    "019cc043-e39a-7712-86ae-4916a7e19df3"
  ]
}
'
{
  "status": "accepted",
  "message": "Your request will be processed in a background job"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
organization_user_ids
string<uuid>[]
required
Minimum array length: 1

The search query to filter leads by.

Example:

"test"

filter
enum<string>

The filter to apply to the leads.

Available options:
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_IN_SUBSEQUENCE,
FILTER_VAL_OPENED_NO_REPLY,
FILTER_VAL_COMPLETED_NO_REPLY,
FILTER_VAL_NO_OPENS,
FILTER_VAL_REPLIED,
FILTER_VAL_LINK_CLICKED
Example:

"FILTER_LEAD_CLOSED"

campaign
string<uuid>

The ID of the campaign to filter leads by.

Example:

"019cc043-e39a-7712-86ae-49146e2761e4"

list_id
string<uuid>

The ID of the list to filter leads by.

Example:

"019cc043-e39a-7712-86ae-4915b73a0295"

in_campaign
boolean

Whether the leads are in the campaign.

Example:

true

in_list
boolean

Whether the leads are in the list.

Example:

true

smart_view_id
string<uuid>

The ID of the smart view to filter leads by.

Example:

"019cc043-e39a-7712-86ae-491736ed444d"

ids
string<uuid>[]

The IDs of the leads to filter by.

limit
integer

The limit of the number of leads to return.

Required range: x >= 0
Example:

10

queries
object[]

Response

Default Response

status
string
Example:

"accepted"

message
string
Example:

"Your request will be processed in a background job"