Skip to main content
POST
cURL
Run one action — delete, unsubscribe, assign_tags, or unassign_tags — over up to 100 contacts at once. IDs that belong to another workspace are silently skipped.

Authorizations

Authorization
string
header
required

HTTP Basic Authentication using API Key and Secret Key. The credentials should be Base64 encoded in the format 'api_key:secret_key'. You can obtain your API Key and Secret Key from Feedspace → Automation → API (https://app.feedspace.io/automation/api).

Body

application/json
action
enum<string>
required

The operation to perform.

Available options:
delete,
unsubscribe,
assign_tags,
unassign_tags
contact_ids
integer[]
required

Contact IDs to act on (1-100).

Required array length: 1 - 100 elements
tag_ids
integer[]

Required when action is assign_tags or unassign_tags. Tag IDs must exist in this workspace.

Response

200 - application/json

Bulk action completed.

action
string
requested_count
integer
affected_count
integer
skipped_count
integer