Bulk Actions

Perform actions on multiple submissions at once — mark read, star, or delete in a single request.

submissions.view

submissions.delete

delete action requires submissions.delete; all others require submissions.view

POST/v1/submissions/bulk

Request Body

Parameter	Type	Description
action*	string	Action to perform: markRead, markUnread, star, unstar, delete
ids*	string[]	Array of submission UUIDs

Example Request

curl

curl -X POST "https://proforms.io/api/v1/submissions/bulk" \
  -H "Authorization: Bearer pf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "markRead",
    "ids": ["sub_abc123", "sub_def456", "sub_ghi789"]
  }'

Response

200 OK

{
  "success": true,
  "data": {
    "action": "markRead",
    "affected": 3
  }
}