Block a Profile

Block a Profile

POST https://api.ocamba.com/v1/hood/profiles/{id}/block
Blocks a profile, placing their contacts into the do not contact (block) list.

Tip
If you don’t know the profile list id, list the profile lists to find it. Consider other options before blocking a profile.
Note
One profile’s contacts can be retrieved from the block list, but a profile cannot be unblocked.
Warning
Once a profile is blocked, they can no longer be engaged.

Rate limits:

  • Burst: 10/s
  • Steady: 150/m

Path parameters

parameters

Request schema

body

Response schemas

204
No Content
curl -X POST \
 "https://api.ocamba.com/v1/hood/profiles/{id}/block" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "This profile'\''s contacts are in many spam lists."
}'
const url = 'https://api.ocamba.com/v1/hood/profiles/{id}/block';
const options = {
  method: 'POST',
  headers: {
    Authorization: "Bearer {TOKEN}",
    'Content-Type': "application/json"
  },
  body: JSON.stringify(
    {
      "reason": "This profile's contacts are in many spam lists."
    }
  )
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
$ch = curl_init("https://api.ocamba.com/v1/hood/profiles/{id}/block");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer {TOKEN}",
  "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(
  [
    "reason" => "This profile's contacts are in many spam lists."
  ]
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Responses

204 No Content

400 Bad Request

{
  "code": 400,
  "title": "Bad request.",
  "message": "The request is not valid.",
  "trace_id": "99a84211-f73d-4ff8-acdf-eb3e06bb9d62"
}

500 Internal Server Error

{
  "code": 500,
  "title": "Internal server error.",
  "trace_id": "99a84211-f73d-4ff8-acdf-eb3e06bb9d62"
}
Responses