Bulk assign leads to organization users

Bulk assign leads to organization users

POST /api/v2/leads/bulk-assign

Bulk assign leads to organization users

cURL

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": [
    "019e3bd1-b5dc-7ca1-91c9-3f9dadfa8ef8"
  ]
}
'

202

{
  "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

search · string

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:

"019e3bd1-b5dc-7ca1-91c9-3f9be64133d8"

list_id · string<uuid>

The ID of the list to filter leads by.

Example:

"019e3bd1-b5dc-7ca1-91c9-3f9c8bc69215"

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:

"019e3bd1-b5dc-7ca1-91c9-3f9e060c5f98"

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[]

Show child attributes

Response

202

application/json

Default Response

status · string

Example:

"accepted"

message · string

Example:

"Your request will be processed in a background job"