Skip to main content
POST
/
v1
/
account-exclusions
Create Account Exclusion
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({domain: '<string>', message: '<string>', until: '2023-11-07T05:31:56Z'})
};

fetch('https://api.topo.io/v1/account-exclusions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "domain": "<string>",
  "message": "<string>",
  "until": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization
string
header
required

Bearer API key issued from Settings → Developers.

Body

application/json

Create Account Exclusion payload

domain
string
required

Account domain to exclude.

reason
enum<string>
required

Why the account is being excluded.

Available options:
BAD_TIMING,
BOUNCED,
COMPETITOR,
CONTACT_REFUSED,
INTERESTED,
MEETING,
OTHER,
OUT_OF_OFFICE,
UNKNOWN,
UNSUBSCRIBED,
WRONG_PERSON,
EXCLUDE_FROM_SEARCH,
EXCLUDE_FROM_CRM,
REFERRAL,
LEFT_COMPANY
message
string | null

Free-form note for operators.

until
string<date-time> | null

When the exclusion expires. Omit for a permanent exclusion.

Response

201 - application/json

Successful Response

id
string<uuid>
required

Unique identifier.

domain
string | null
required

Excluded account domain.

reason
enum<string>
required

Reason for the exclusion.

Available options:
BAD_TIMING,
BOUNCED,
COMPETITOR,
CONTACT_REFUSED,
INTERESTED,
MEETING,
OTHER,
OUT_OF_OFFICE,
UNKNOWN,
UNSUBSCRIBED,
WRONG_PERSON,
EXCLUDE_FROM_SEARCH,
EXCLUDE_FROM_CRM,
REFERRAL,
LEFT_COMPANY
message
string | null
required

Operator note.

until
string<date-time> | null
required

When the exclusion expires.

created_at
string<date-time>
required

When the exclusion was created.

updated_at
string<date-time>
required

When the exclusion last changed.