Block People

Adds up to 1,000 people to the block list by first and last name, optionally with a LinkedIn profile, and answers every item in added, already_blocked or invalid. A name entry blocks every person with that first and last name in this workspace; the name match ignores case and punctuation. A repeat lands in already_blocked. Safe to retry: a repeat never writes a second entry. Free, no credits; spends no rate-limit units, but counts against the per-second window of the search bucket. Blocked people and companies are left out of people and company search, people and company enrich, email find and suggestions in this workspace, within 15 seconds. Saving a person by id and email verify are not filtered by workspace block lists, and blocked domains that resolve to more than 10,000 companies are only partly excluded from people search. Any member or API key of the workspace may call it; a credential that belongs to no workspace answers 403.

Body parameters

• dataobject[]required

  The people to block, 1 to 1,000.

  Field	Type	Description
  first_name	stringrequired	First name. Empty, or only spaces, hyphens and apostrophes, puts the item in invalid (missing_field). max length: 200. Example: "John"
  last_name	stringrequired	Last name. Empty, or only spaces, hyphens and apostrophes, puts the item in invalid (missing_field). max length: 200. Example: "Smith"
  linkedin_url	string	Also block this LinkedIn profile (https://linkedin.com/in/<profile>). Not a profile URL: the item goes to invalid (invalid_format). max length: 200. Example: "https://linkedin.com/in/john-smith"
  identifier	string	Your key for this item, echoed in the answer. Defaults to the item index. max length: 200.

Responses

• 200 Every item, in one of the three buckets; the item counts in metadata.
• 400 Invalid body (VALIDATION_ERROR): missing_field (data), out_of_range (no items, more than 1,000, or a string over 200 characters), wrong_type, unknown_field (with allowed_fields), or conflicting_fields (one identifier on two different items, listed in payload.conflicts). An item that is only unusable lands in invalid instead.
• 401 Missing, unknown or inactive credentials (UNAUTHORIZED).
• 403 The credential belongs to no workspace (FORBIDDEN, workspace_required).
• 409 The add would take the list past its cap of 200,000 people (CONFLICT, limit_reached, with payload.limit and payload.current_count). Nothing was written.
• 429 Over the per-second window of the search bucket (RATE_LIMIT). Sent only where rate-limit enforcement is on; wait Retry-After seconds.
• 500 Unexpected server error; also, rarely, a concurrent change of the same entries. Safe to retry.

For error handling see Errors. Response objects are described in Person object and Company object.