Blocked Handles

Block a handle

Blocks a handle — an E.164 phone number, an email address (iMessage sender), an SMS short code (e.g. 262966), or an alphanumeric sender ID. Inbound messages from it are dropped and produce no webhooks, and direct sends to it are rejected with 403 (error code 2026); group sends that include unblocked members are not restricted. Blocking is idempotent — re-blocking an already blocked handle returns the existing entry.

post/v3/blocked_handles

Request

  • Base URL: https://api.linqapp.com/api/partner
  • URL: https://api.linqapp.com/api/partner/v3/blocked_handles
  • Auth: HTTP bearer

Request body

handlestring required

The handle to block: an E.164 phone number, an email address, an SMS short code (3-8 digits), or an alphanumeric sender ID.

reasonstring

Optional free-text note on why the handle was blocked

Example request

{
  "handle": "+12025551234",
  "reason": "spam"
}

Response

Handle blocked successfully

Example response

{
  "blocked_handle": {
    "handle": "+12025551234",
    "reason": "spam",
    "blocked_at": "2026-07-30T16:42:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.