P
ProFormsDocs

Blocked Senders

List and unblock senders that have been blocked from submitting forms. Blocked senders are grouped by the submission that triggered the block.

List Blocked Senders

Retrieve all blocked senders for your organization, grouped by source submission with stats by type.

GET/v1/settings/blocked-senders

Example Request

curl
curl "https://proforms.io/api/v1/settings/blocked-senders" \
  -H "Authorization: Bearer pf_your_api_key"

Response

200 OK
{
  "success": true,
  "data": {
    "groups": [
      {
        "key": "sub_12345",
        "identifiers": [
          {
            "id": 1,
            "type": "email",
            "rawValue": "spammer@example.com"
          },
          {
            "id": 2,
            "type": "phone",
            "rawValue": "(555) 867-5309"
          }
        ],
        "blockedBy": "user",
        "reason": "Repeated spam submissions",
        "createdAt": "2026-02-17T09:15:00.000Z",
        "submission": {
          "uuid": "sub_def456",
          "referenceId": "CF-0042",
          "senderName": "Spam Bot",
          "formName": "Contact Form",
          "siteName": "Main Website",
          "submittedAt": "2026-02-17T09:10:00.000Z"
        }
      }
    ],
    "stats": {
      "totalSenders": 1,
      "totalIdentifiers": 2,
      "byType": {
        "email": 1,
        "phone": 1
      }
    }
  }
}
ℹī¸
Each group represents a single blocked sender. A sender may have multiple blocked identifiers (email and phone) that were all extracted from the same submission.

Unblock Sender

Remove one or more blocked sender identifiers by ID. Use the id values from the identifiers array in the list response.

DELETE/v1/settings/blocked-senders

Request Body

idinteger

Single identifier ID to unblock

idsinteger[]

Array of identifier IDs to unblock in bulk

Example Request (single)

curl
curl -X DELETE "https://proforms.io/api/v1/settings/blocked-senders" \
  -H "Authorization: Bearer pf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 1
  }'

Example Request (bulk)

curl
curl -X DELETE "https://proforms.io/api/v1/settings/blocked-senders" \
  -H "Authorization: Bearer pf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [1, 2, 3]
  }'

Response

200 OK
{
  "success": true,
  "data": {
    "deleted": 3
  }
}
💡
To unblock all identifiers for a sender, pass all their id values from the group's identifiers array. Provide either id or ids, not both.